DESCRIPTION

These are the resources of the Core class, of which all widget classes are subclasses. They are described here to avoid repeating their descriptions for each widget.

RESOURCES

 _______________________________________________________________________
|___________________________Core_Resource_Set__________________________|
| Name                |  Class               |  Type          |  Access|
|_____________________|______________________|________________|________|
| XtNancestorSensitive|  XtCSenstitive       |  Boolean       |  G*    |
|_____________________|______________________|________________|________|
|_XtNbackground_______|__XtCBackground_______|__Pixel_________|__SGI-__|
| XtNbackgroundPixmap |  XtCPixmap           |  Pixmap        |  SGI-  |
|_____________________|______________________|________________|________|
|_XtNborderColor______|__XtCBorderColor______|__Pixel_________|__SGI-__|
| XtNborderPixmap     |  XtCPixmap           |  Pixmap        |  SGI-  |
|_____________________|______________________|________________|________|
|_XtNborderWidth______|__XtCBorderWidth______|__Dimension_____|__SGI___|
| XtNdepth            |  XtCDepth            |  int           |  GI    |
|_____________________|______________________|________________|________|
|_XtNdestroyCallback__|__XtCCallback_________|__XtCallbackList|__SI____|
| XtNheight           |  XtCHeight           |  Dimension     |  SGI   |
|_____________________|______________________|________________|________|
|_XtNmanaged__________|__XtCManaged__________|__Boolean_______|__TRUE__|
| XtNmappedWhenManaged|  XtCMappedWhenManaged|  Boolean       |  SGI   |
|_____________________|______________________|________________|________|
|_XtNsensitive________|__XtCSensitive________|__Boolean_______|__GI*___|
| XtNtranslations     |  XtCTranslations     |  XtTranslations|  G     |
|_____________________|______________________|________________|________|
|_XtNwidth____________|__XtCWidth____________|__Dimension_____|__SGI___|
| XtNx                |  XtCPosition         |  Position      |  SGI   |
|_____________________|______________________|________________|________|
|_XtNy________________|__XtCPosition_________|__Position______|__SGI___|

 The following resource, although not  a  Core  resource,  is
 available to all widgets:
          __________________________________________
         |_Name______|_Class_____|_Type____|_Access|
         |___________|___________|_________|_______|
         |_XtNuserDat|_XtCUserDat|_XtPointe|_SGI___|

 XtNancestorSensitive Range of Values:
      TRUE
      FALSE
 This argument specifies whether the immediate parent of  the
 widget   will   receive  input  events.   To  preserve  data
 integrity, the application should use  the  XtSetSensitive()
 routine if it wants to change the resource (see XtNsensitive
 below).

 XtNbackground

 Range of Values:

(any Pixel value valid for the current display)/(any name from the rgb.txt file)

This resource specifies the background color for the widget. Note that the OPEN LOOK workspace manager arranges for a ``normal video'' (or ``reverse video'') effect on monochrome displays by setting the XtNbackground resource to white (black) and the XtNforeground, XtNfontColor, and XtNborder-Color resources to black (white) where appropriate. The workspace manager also provides end user access to some of these resources on polychrome displays. However, any color set by the application when a widget is created or in a later call to XtSetValues() will override the colors set by the user. Thus applications should consider this and avoid setting these resources directly, letting the user have control over them.

XtNbackgroundPixmap The application can specify a pixmap to be used for tiling the background. The first tile is placed at the upper left hand corner of the widget's window. This resource takes precedence over the XtNbackground resource. See the note about the interaction of this resource with other color resources under the description of the XtNbackground resource above.

XtNborderColor

Range of Values:

(any Pixel value valid for the current display)/(any name from the rgb.txt file)

This resource specifies the color of the border. See the note about the interaction of this resource with other color resources under the description of the XtNbackground resource above.

XtNborderPixmap

The application can specify a pixmap to be used for tiling the border. The first tile is placed at the upper left hand corner of the border. This resource takes precedence over the XtNborderColor resource. See the note about the interaction of this resource with other color resources under the description of the XtNbackground resource above.

XtNborderWidth

Range of Values:

     0 < XtNborderWidth < min(XtNwidth, XtNheight) / 2

This resource sets the width of the border for a widget. Typically the border surrounds the widget's window on all four sides, but in some widgets it is inside the widget, surrounding a view or control area contained in the widget. The width is specified in pixels, and a width of zero means no border will show.

XtNdepth

Range of Values:

     0 or (any value supported by the current display)

Determines how many bits should be used for each pixel in the widget's window. The value of this resource is used by the X Toolkit Intrinsics to set the depth of the widget's window when the widget is created. A value of zero causes a normal widget to inherit the depth of its parent, or a popup widget to inherit the default depth of the screen.

XtNdestroyCallback This is a pointer to a callback list containing routines to be called when the widget is destroyed.

XtNheight

Range of Values:

     0 < XtNheight

This resource contains the height of the widget's window in pixels, not including the border area. Programs may request a value at creation or through later calls to XtSetValues(), but the request may not succeed because of layout requirements of the parent widget. The visual representations for some widgets have a fixed height for a given scale. For these widgets, the XtNheight resource gives the height of the space that contains the widget's representation; the representation is centered vertically in this space unless otherwise specified.

XtNmanaged Range of Values:
     TRUE
     FALSE
If this resource is set to TRUE, the widget is  included  in
the  geometry  calculations  of  its  parent.  If FALSE, the
widget is ignored by its parent and is not included  in  the
geometry calculations.

XtNmappedWhenManaged

Range of Values:
     TRUE
     FALSE

If set to TRUE, the widget will be mapped (made visible) as soon as it is both realized and managed. If set to FALSE, the program 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.

XtNsensitive

Range of Values:
     TRUE
     FALSE

This resource determines whether a widget will receive input events. If a widget is sensitive, the X Toolkit Intrinsic's 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. Also, insensitive widgets that appear on the screen are stippled with a 50% gray pattern to show that they are inactive, as a visual indication that the user can't interact with the widget. The 50% gray pattern is one that makes every other pixel of the widget the background color, in a checkerboard pattern. An application should use the XtSetSensitive() routine if it wants to change this resource. That way it ensures that if a parent widget has XtNsensitive set to FALSE, the XtNancestorSensitive flag of all its descendants will be appropriately set.

XtNtranslations This resource should not be set by an application.

XtNuserData Default value: (XtPointer) NULL This resource provides storage for application-specific data. It is not used or set by the widget.

XtNwidth

Range of Values:

     0 < XtNwidth

This resource contains the width of the widget's window in pixels, not including the border area. Programs may request a value at creation or through later calls to XtSetValues(), but the request may not succeed because of layout requirements of the parent widget.

The visual representations for some widgets have a fixed width for a given scale. For these widgets, the XtNwidth resource gives the width of the space that contains the widget's representation; the representation is centered horizontally in this space unless otherwise specified.

XtNx

Range of Values:

     0 < XtNx

This argument contains the x-coordinate of the widget's upper left hand corner (excluding the border) relative to its parent widget. Programs may request a value at creation or through later calls to XtSetValues(), but the request may not succeed because of layout requirements of the parent widget.

XtNy

Range of Values:
     0 < XtNy
This resource contains  the  y-coordinate  of  the  widget's
upper  left  hand  corner (excluding the border) relative to
its parent widget.  Programs may request a value at creation
or through later calls to XtSetValues(), but the request may
not succeed because of layout  requirements  of  the  parent
widget.