Core(Xm) UNIX System V
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(Xm).
(printed 2/14/90) Core(Xm)