Core(3Xm) — UNIX Programmer’s Manual
NAME
Core — the Core widget class.
SYNOPSIS
#include <Xm/Xm.h>
DESCRIPTION
Core is the Xt Intrinsic base class for windowed widgets.
To add support for windowless widgets, three additional classes have been added above Core in the class hierarchy. They are Object, RectObj, and WindowObj. WindowObj is a synonym of Core that provides no added functionality but was necessary for implementation reasons.
Classes
All widgets are built from Core.
The class pointer is widgetClass.
The class name is Core.
New Resources
The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in a .Xdefaults file, remove the XmN or XmC prefix and use the remaining letters. To specify one of the defined values for a resource in a .Xdefaults file, remove the Xm prefix and use the remaining letters (in either lower case or upper case, but include any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (C), set by using XtSetValues (S), retrieved by using XtGetValues (G), or is not applicable (N/A).
| Core Resource Set | ||||
| Name | Class | Type | Default | Access |
| XmNaccelerators | XmCAccelerators | XtTranslations | NULL | CSG |
| XmNancestorSensitive | XmCSensitive | Boolean | True | G |
| XmNbackground | XmCBackground | Pixel | White | CSG |
| XmNbackgroundPixmap | XmCPixmap | Pixmap | XmUNSPECIFIED_PIXMAP | CSG |
| XmNborderColor | XmCBorderColor | Pixel | Black | CSG |
| XmNborderPixmap | XmCPixmap | Pixmap | XmUNSPECIFIED_PIXMAP | CSG |
| XmNborderWidth | XmCBorderWidth | Dimension | 1 | CSG |
| XmNcolormap | XmCColormap | Colormap | XtCopyFromParent | CG |
| XmNdepth | XmCDepth | int | XtCopyFromParent | CG |
| XmNdestroyCallback | XmCCallback | XtCallbackList | NULL | C |
| XmNheight | XmCHeight | Dimension | 0 | CSG |
| XmNmappedWhenManaged | XmCMappedWhenManaged | Boolean | True | CSG |
| XmNscreen | XmCScreen | Pointer | XtCopyScreen | CG |
| XmNsensitive | XmCSensitive | Boolean | True | CSG |
| XmNtranslations | XmCTranslations | XtTranslations | NULL | CSG |
| XmNwidth | XmCWidth | Dimension | 0 | CSG |
| XmNx | XmCPosition | Position | 0 | CSG |
| XmNy | XmCPosition | Position | 0 | CSG |
XmNaccelerators
Specifies a translation table that is bound with its actions in the context of a particular widget. The accelerator table can then be installed on some destination widget.
XmNancestorSensitive
Specifies whether the immediate parent of the widget will receive input events. Use the function XtSetSensitive to change the argument to preserve data integrity (see XmNsensitive below).
XmNbackground
Specifies the background color for the widget.
XmNbackgroundPixmap
Specifies a pixmap for tiling the background. The first tile is placed at the upper left-hand corner of the widget’s window.
XmNborderColor
Specifies the color of the border in a pixel value.
XmNborderPixmap
Specifies a pixmap to be used for tiling the border. The first tile is placed at the upper left-hand corner of the border.
XmNborderWidth
Specifies the width of the border that surrounds the widget’s window on all four sides. The width is specified in pixels. A width of zero means that no border will show.
XmNcolormap
Specifies the colormap that will be used for conversions to the type Pixel for this widget instance. When changed, previously generated pixel values will not be affected, but newly generated values will be in the new colormap.
XmNdepth
Specifies the number of bits that can be used for each pixel in the widget’s window. Applications should not change or set the value of this resource as it is set by the Xt Intrinsics when the widget is created.
XmNdestroyCallback
Specifies a list of callbacks that is called when the widget is destroyed.
XmNheight
Specifies the height of the widget’s window in pixels, not including the border area.
XmNmappedWhenManaged
Maps the widget (makes visible) as soon as it is both realized and managed, if set to True. If set to False, the client is responsible for mapping and unmapping the widget. If the value is changed from True to False after the widget has been realized and managed, the widget is unmapped.
XmNscreen
Specifies the screen on which a widget instance resides. It is read only, except for shells.
XmNsensitive
Determines whether a widget will receive input events. If a widget is sensitive, the Xt Intrinsics’ Event Manager will dispatch to the widget all keyboard, mouse button, motion, window enter/leave, and focus events. Insensitive widgets do not receive these events. Use the function XtSetSensitive to change the sensitivity argument. Using XtSetSensitive ensures that if a parent widget has XmNsensitive set to False, the ancestor-sensitive flag of all its children will be appropriately set.
XmNtranslations
Points to a translations list. A translations list is a list of events and actions that are to be performed when the events occur.
XmNwidth
Specifies the width of the widget’s window in pixels, not including the border area.
XmNx
Specifies the x-coordinate of the widget’s upper left-hand corner (excluding the border) in relation to its parent widget.
XmNy
Specifies the y-coordinate of the widget’s upper left-hand corner (excluding the border) in relation to its parent widget.
RELATED INFORMATION
7th Edition