Core(3X) UNIX System V Core(3X)
NAME
Core - The Core widget class
SYNOPSIS
#include <Xm/Xm.h>
VERSION
This page documents version 1.2 of the Motif library.
DESCRIPTION
Core is the Xt Intrinsic base class for windowed widgets.
The Object and RectObj classes provide support for
windowless widgets.
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
lowercase or uppercase, 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 XtAccelerators dynamic CSG
XmNancestorSensitive XmCSensitive Boolean dynamic G
XmNbackground XmCBackground Pixel dynamic CSG
XmNbackgroundPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG
XmNborderColor XmCBorderColor Pixel XtDefaultForeground CSG
XmNborderPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG
XmNborderWidth XmCBorderWidth Dimension 1 CSG
XmNcolormap XmCColormap Colormap dynamic CG
XmNdepth XmCDepth int dynamic CG
XmNdestroyCallback XmCCallback XtCallbackList NULL C
Page 1 (printed 4/30/98)
Core(3X) UNIX System V Core(3X)
XmNheight XmCHeight Dimension dynamic CSG
XmNinitialResourcesPersistent XmCInitialResourcesPersistent Boolean True C
XmNmappedWhenManaged XmCMappedWhenManaged Boolean True CSG
XmNscreen XmCScreen Screen * dynamic CG
XmNsensitive XmCSensitive Boolean True CSG
XmNtranslations XmCTranslations XtTranslations dynamic CSG
XmNwidth XmCWidth Dimension dynamic 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 receives input events. Use the function
XtSetSensitive to change the argument to preserve
data integrity (see XmNsensitive below). For
shells, the default is copied from the parent's
XmNancestorSensitive resource if there is a
parent; otherwise, it is True. For other widgets,
the default is the bitwise AND of the parent's
XmNsensitive and XmNancestorSensitive resources.
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 shows.
XmNcolormap
Page 2 (printed 4/30/98)
Core(3X) UNIX System V Core(3X)
Specifies the colormap that is used for
conversions to the type Pixel for this widget
instance. When changed, previously generated
pixel values are not affected, but newly generated
values are in the new colormap. For shells
without parents, the default is the default
colormap of the widget's screen. Otherwise, the
default is copied from the parent.
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. For shells without
parents, the default is the default depth of the
widget's screen. Otherwise, the default is copied
from the parent.
XmNdestroyCallback
Specifies a list of callbacks that is called when
the widget is destroyed.
XmNheight Specifies the inside height (excluding the border)
of the widget's window.
XmNinitialResourcesPersistent
Specifies whether or not resources are reference
counted. If the value is True when the widget is
created, the resources referenced by the widget
are not reference counted, regardless of how the
resource type converter is registered. An
application that expects to destroy the widget and
wants to have resources deallocated should specify
a value of False. The default is True, implying
an assumption that the widget will not be
destroyed during the life of the application.
XmNmappedWhenManaged
If set to True it maps the widget (makes it
visible) as soon as it is both realized and
managed. 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. When the Toolkit is
initialized, the top-level widget obtains its
default value from the default screen of the
display. Otherwise, the default is copied from
the parent.
Page 3 (printed 4/30/98)
Core(3X) UNIX System V Core(3X)
XmNsensitive
Determines whether a widget receives input events.
If a widget is sensitive, the Xt Intrinsics' Event
Manager dispatches 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 is 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 inside width (excluding the border)
of the widget's window.
XmNx Specifies the x-coordinate of the upper left
outside corner of the widget's window. The value
is relative to the upper left inside corner of the
parent window.
XmNy Specifies the y-coordinate of the upper left
outside corner of the widget's window. The value
is relative to the upper left inside corner of the
parent window.
Translations
There are no translations for Core.
RELATED INFORMATION
Object(3X) and RectObj(3X).
Page 4 (printed 4/30/98)