Core(3Xm)

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
WindowObj(3Xm).