'\"!  tbl | tbl | tbl | tbl | tbl | tbl | mmdoc
'\"macro stdmacro
.if n .pH g3w.olCorRsourc @(#)olCorRsourc	40.3 of 1/8/90
.ds oS CORE
.nr oN 0
.nr X
.if \nX=0 .ds x} ""CORE RESOURCES" 3W "\&"
.if \nX=1 .ds x} ""CORE RESOURCES" 3W
.if \nX=2 .ds x} ""CORE RESOURCES" "" "\&"
.if \nX=3 .ds x} ""CORE "" "" "\&"
.TH \*(x}
.SH "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.
.SH "RESOURCES"
.ds cO
.TS 
expand,allbox;
cB s s s.
Core Resource Set
.T&
l1Bp-2 l1Bp-2 lw1Bp-2 lw1Bp-2.
Name	Class	Type	Access
_
.T&
l1p-2 l1p-2 l1p-2 l1p-2.
XtNancestorSensitive	XtCSenstitive	Boolean	G*
XtNbackground	XtCBackground	Pixel	SGI\(dg
XtNbackgroundPixmap	XtCPixmap	Pixmap	SGI\(dg
XtNborderColor	XtCBorderColor	Pixel	SGI\(dg
XtNborderPixmap	XtCPixmap	Pixmap	SGI\(dg
XtNborderWidth	XtCBorderWidth	Dimension	SGI
XtNdepth	XtCDepth	int	GI
XtNdestroyCallback	XtCCallback	XtCallbackList	SI
XtNheight	XtCHeight	Dimension	SGI
XtNmanaged	XtCManaged	Boolean	TRUE	SGI
XtNmappedWhenManaged	XtCMappedWhenManaged	Boolean	SGI
XtNsensitive	XtCSensitive	Boolean	GI*
XtNtranslations	XtCTranslations	XtTranslations	G
XtNwidth	XtCWidth	Dimension	SGI
XtNx	XtCPosition	Position	SGI
XtNy	XtCPosition	Position	SGI
.TE
.sp
The following resource, although not a Core resource, 
is available to all widgets:
.TS
center, allbox;
l1Bp-2 l1Bp-2 lw1Bp-2 lw1Bp-2
l1p-2w(1i) l1p-2w(1i) l1p-2w(0.75i) l1p-2w(0.5i).
Name	Class	Type	Access
_
XtNuserData	XtCUserData	XtPointer	SGI
.TE
.sp
\f3XtNancestorSensitive\f1
.P
Range of Values:
.br
.in +5
.nf
\f4TRUE
FALSE\f1
.in -5
.fi
.P
This argument specifies whether the immediate parent of the
widget will receive input events.
To preserve data integrity, the application should use the
\f4XtSetSensitive()\f1
routine if it wants to change the resource 
(see
\f4XtNsensitive\f1
below).
.sp
\f3XtNbackground\f1
.PP
Range of Values:
.br
.in +5
\f1(any \f4Pixel \f1value valid for the current display)/(any name from the \f4rgb.txt \f1file)\f1
.in -5
.PP
This resource specifies the background color for the widget.  
.P
Note that the OPEN LOOK workspace manager arranges for a
``normal video'' (or ``reverse video'') effect on monochrome
displays by setting the
\f4XtNbackground\f1
resource to white (black) and the
\f4XtNforeground\f1,
\f4XtNfontColor\f1,
and
\f4XtNborderColor\f1
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
\f4XtSetValues()\f1
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.
.sp
\f3XtNbackgroundPixmap\f1
.P
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.  
.P
This resource takes precedence over the
\f4XtNbackground\f1
resource.
.P
See the note about the interaction of this resource with other
color resources under the description of the
\f4XtNbackground\f1
resource above.
.sp
\f3XtNborderColor\f1
.PP
Range of Values:
.br
.in +5
\f1(any \f4Pixel \f1value valid for the current display)/(any name from the \f4rgb.txt \f1file)
.in -5
.PP
This resource specifies the color of the border.
.P
See the note about the interaction of this resource with other
color resources under the description of the
\f4XtNbackground\f1
resource above.
.sp
\f3XtNborderPixmap\f1
.PP
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.
.P
This resource takes precedence over the
\f4XtNborderColor\f1
resource.
.P
See the note about the interaction of this resource with other
color resources under the description of the
\f4XtNbackground\f1
resource above.
.sp
\f3XtNborderWidth\f1
.PP
Range of Values:
.br
.in +5
.vA
\f40 \(<= XtNborderWidth \(<= min(XtNwidth\f1, \f4XtNheight\f1) \f4/ 2\f1
.in -5
.PP
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.
.bp
\f3XtNdepth\f1
.PP
Range of Values:
.br
.in +5
\f40 \f2or \f1(any value supported by the current display)\f1
.in -5
.fi
.PP
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 pop-up widget to inherit the default depth of the screen.
.sp
\f3XtNdestroyCallback\f1
.P
This is a pointer to a callback list containing routines to be
called when the widget is destroyed.
.sp
\f3XtNheight\f1
.PP
Range of Values:
.br
.in +5
\f40 \(<= XtNheight\f1
.in -5
.PP
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
\f4XtSetValues()\f1,
but the request may not succeed because of layout requirements of
the parent widget.
.P
The visual representations for some widgets have a fixed height
for a given scale.
For these widgets, the
\f4XtNheight\f1
resource gives the height of the space that contains the
widget's representation;
the representation is centered vertically in this space unless
otherwise specified.
.sp
\fBXtNmanaged\fP
.P
Range of Values:
.br
.in +5
.nf
\f(CWTRUE
FALSE\fP
.fi
.in -5
If this resource is set to \f(CWTRUE\fP, the widget is included in
the geometry calculations of its parent.  If \f(CWFALSE\fP, the widget
is ignored by its parent and is not included in the geometry
calculations. 
.sp
\f3XtNmappedWhenManaged\f1
.PP
Range of Values:
.br
.in +5
.nf
\f4TRUE
FALSE\f1
.in -5
.fi
.PP
If set to
\f4TRUE\f1,
the widget will be mapped
(made visible)
as soon as it is both realized and managed.
If set to
\f4FALSE\f1,
the program is responsible for mapping and unmapping the widget.
If the value is changed from
\f4TRUE\f1
to
\f4FALSE\f1
after the widget has
been realized and managed,
the widget is unmapped.
.bp
\f3XtNsensitive\f1
.PP
Range of Values:
.br
.in +5
.nf
\f4TRUE
FALSE\f1
.in -5
.fi
.PP
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.
.P
An application should use the
\f4XtSetSensitive()\f1
routine if it wants to change this resource.
That way it ensures that if a parent widget has
\f4XtNsensitive\f1
set to
\f4FALSE\f1,
the
\f4XtNancestorSensitive\f1
flag of all its descendants will be appropriately set.
.sp
\f3XtNtranslations\f1
.P
This resource should not be set by an application.
.sp
\f3XtNuserData\f1
.P
Default value:  \f(CW(XtPointer) NULL\fP
.P
This resource provides storage for application-specific data. It
is not used or set by the widget.
.sp
\f3XtNwidth\f1
.PP
Range of Values:
.br
.in +5
.nf
\f40 \(<= XtNwidth\f1
.in -5
.fi
.PP
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
\f4XtSetValues()\f1,
but the request may not succeed because of layout requirements of
the parent widget.
.sp
The visual representations for some widgets have a fixed width
for a given scale.
For these widgets, the
\f4XtNwidth\f1
resource gives the width of the space that contains the
widget's representation;
the representation is centered horizontally in this space unless
otherwise specified.
.sp
\f3XtNx\f1
.PP
Range of Values:
.br
.in +5
.nf
\f40 \(<= XtNx\f1
.in -5
.fi
.PP
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
\f4XtSetValues()\f1,
but the request may not succeed because of layout requirements of
the parent widget.
.bp
\f3XtNy\f1
.PP
Range of Values:
.br
.in +5
.nf
\f40 \(<= XtNy\f1
.in -5
.fi
.P
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
\f4XtSetValues()\f1,
but the request may not succeed because of layout requirements of
the parent widget.
