WIDGET CLASS NAME

FlatNonexclusives

SYNOPSIS

#include <Intrinsic.h>
#include <StringDefs.h>
#include <OpenLook.h>
#include <FCheckBox.h>

widget = XtCreateWidget(name, flatCheckBoxWidgetClass, ...);

DESCRIPTION

              Figure 1.  Flat CheckBox Widget
FlatCheckbox Coloration The FlatCheckBox container  inherits
its  background  color  from  the container's parent widget.
Setting the background color affects only  the  sub-objects'
background.

RESOURCES

The following table lists the resources for the FlatCheck-Box. Resources that have a bullet (•) in the Access column denote sub-object resources. If these resources are not included in the XtNitemFields list, they are inherited from the container widget. An application can change the default values for sub-object resources by setting them directly on the container. Even though a sub-object resource is not included in the XtNitemFields list, the application can query the value of any sub-object resource with OlFlatGet-Values().

 ____________________________________________________________________________________________
 _________________________________Flat_CheckBox_Resource_Set_________________________________
  Name                   Class                  Type            Default               Access
 ____________________________________________________________________________________________
 _XtNancestorSensitive___XtCSensitive___________Boolean_________TRUE__________________G•_____
  XtNbackground          XtCBackground          Pixel           XtDefaultBackground   SGI•
 ____________________________________________________________________________________________
 _XtNbackgroundPixmap____XtCBackgroundPixmap____Pixmap__________None__________________SGI•___
  XtNborderWidth         XtCBorderWidth         Dimension       0                     SGI•
 ____________________________________________________________________________________________
 _XtNclientData__________XtCClientData__________XtPointer_______NULL__________________SGI•___
  XtNdepth               XtCDepth               Cardinal        (parent's)            GI
 ____________________________________________________________________________________________
 _XtNfont________________XtCFont________________XFontStruct_*___(OPEN_LOOK_font)______SI•____
  XtNfontColor           XtCFontColor           Pixel           XtDefaultForeground   SGI•
 ____________________________________________________________________________________________
 _XtNforeground__________XtCForeground__________Pixel___________XtDefaultForeground___SGI____
  XtNgravity             XtCGravity             int             CenterGravity         SGI
 ____________________________________________________________________________________________
 _XtNhPad________________XtCHPad________________Dimension_______0_____________________SGI____
  XtNhSpace              XtCHSpace              Dimension       (calculated)          SGI
 ____________________________________________________________________________________________
 _XtNheight______________XtCHeight______________Dimension_______(calculated)__________SGI____
  XtNitemFields          XtCItemFields          String *        NULL                  GI
 ____________________________________________________________________________________________
 _XtNitemGravity_________XtCItemGravity_________int_____________NorthWestGravity______SGI____
  XtNitemMaxHeight       XtCItemMaxHeight       Dimension       OL_IGNORE             SGI
 ____________________________________________________________________________________________
 _XtNitemMaxWidth________XtCItemMaxWidth________Dimension_______OL_IGNORE_____________SGI____
  XtNitemMinHeight       XtCItemMinHeight       Dimension       OL_IGNORE             SGI
 ____________________________________________________________________________________________
 _XtNitemMinWidth________XtCItemMinWidth________Dimension_______OL_IGNORE_____________SGI____
  XtNitems               XtCItems               XtPointer       NULL                  SGI
 ____________________________________________________________________________________________
 _XtNitemsTouched________XtCItemsTouched________Boolean_________FALSE_________________SG_____
  XtNlabel               XtCLabel               String          NULL                  SGI•
 ____________________________________________________________________________________________
 _XtNlabelImage__________XtCLabelImage__________XImage_*________NULL__________________SGI•___
  XtNlabelJustify        XtCLabelJustify        OlDefine        OL_LEFT               SGI•
 ____________________________________________________________________________________________
 _XtNlabelTile___________XtCLabelTile___________Boolean_________FALSE_________________SGI•___
  XtNlayoutHeight        XtCLayoutHeight        OlDefine        OL_MINIMIZE           SGI
 ____________________________________________________________________________________________
 _XtNlayoutType__________XtCLayoutType__________OlDefine________OL_FIXEDROWS__________SGI____
  XtNlayoutWidth         XtCLayoutWidth         OlDefine        OL_MINIMIZE           SGI
 ____________________________________________________________________________________________
 _XtNmanaged_____________XtCManaged_____________Boolean_________TRUE__________________SGI____
  XtNmappedWhenManaged   XtCMappedWhenManaged   Boolean         TRUE                  SGI•
 ____________________________________________________________________________________________
 _XtNmeasure_____________XtCMeasure_____________int_____________1_____________________SGI____
  XtNnumItemFields       XtCNumItemFields       Cardinal        0                     SGI
 ____________________________________________________________________________________________
  XtNnumItems            XtCNumItems            Cardinal        0                     SGI

 ____________________________________________________________________________________________
|_XtNposition____________XtCPosition____________OlDefine________OL_LEFT_______________SGI•__|

 ____________________________________________________________________________
|_____________________Flat_CheckBox_Resource_Set_(cont.)____________________|
| Name           |  Class          |  Type          |  Default     |  Access|
|________________|_________________|________________|______________|________|
|_XtNsameHeight__|__XtCSameHeight__|__OlDefine______|__OL_ALL______|__SGI___|
| XtNsameWidth   |  XtCSameWidth   |  OlDefine      |  OL_COLUMNS  |  SGI   |
|________________|_________________|________________|______________|________|
|_XtNselectProc__|__XtCCallbackProc|__XtCallbackProc|__NULL________|__SGI•__|
| XtNsensitive   |  XtCSensitive   |  Boolean       |  TRUE        |  SGI•  |
|________________|_________________|________________|______________|________|
|_XtNset_________|__XtCSet_________|__Boolean_______|__FALSE_______|__SGI-•_|
| XtNunselectProc|  XtCCallbackProc|  XtCallbackProc|  NULL        |  SGI•  |
|________________|_________________|________________|______________|________|
|_XtNuserData____|__XtCUserData____|__XtPointer_____|__NULL________|__SGI•__|
| XtNvPad        |  XtCVPad        |  Dimension     |  0           |  SGI   |
|________________|_________________|________________|______________|________|
|_XtNvSpace______|__XtCVSpace______|__Dimension_____|__(calculated)|__SGI___|
| XtNwidth       |  XtCWidth       |  Dimension     |  (calculated)|  SGI   |
|________________|_________________|________________|______________|________|
|_XtNx___________|__XtCPosition____|__Position______|__0___________|__SGI___|
| XtNy           |  XtCPosition    |  Position      |  0           |  SGI   |
|________________|_________________|________________|______________|________|

 XtNancestorSensitive Range of Values:
                 TRUE/"true"
                 FALSE/"false"

This resource indicates the sensitivity of the sub-object's ancestors. If TRUE, all the sub-object's ancestors are sensitive and the sub-object is sensitive to user input. If FALSE, one or more of the sub-object's ancestors are insensitive, so the sub-object displays an inactive visual and is not sensitive to user input.

XtNbackground This is the pixel color used to fill in the background of the check box.

XtNbackgroundPixmap This resource specifies the pixmap that is displayed as the sub-object's label. Any supplied pixmap must have the same depth as the flat widget's depth. Pixmaps of None and ParentRelative are not considered valid values. If either XtNlabel or XtNlabelImage has a non-NULL value, this resource is ignored.

XtNclientData This is the client data supplied to all callback procedures.

XtNfont This resource displays the string specified by the XtNlabel resource.

XtNfontColor This resource specifies the foreground color of the sub-object's label, even if the label is an XImage.

XtNforeground This is the pixel color used when drawing the check box and the check within the check box.

XtNitems This is the list of sub-object items. This value must point to a static list since flat containers reference this list after initialization but do not cache its information.

XtNitemFields This is the list of resource names used to parse the records in the XtNitems list. This resource does not have to point to static information since the flat container does not use this information after initialization. Though the flat container does not reference this resource's value after initialization, it holds onto it for responding to an XtGetValues() request and supplying it in the OlFlat-CallData structure during callbacks. Therefore, if the application plans on querying this resource, it's recommended that the application make this resource point to static information.

XtNitemsTouched
Range of Values:
                TRUE
                FALSE
Whenever the application modifies an item list directly,  it
must supply this resource (with a value of TRUE) to the flat
widget container  so  that  the  container  can  update  the
visual.   If the resource value is supplied, the flat widget
container treats its current item list as  a  new  list  and
hence, updates its entire visual.  Since the list is treated
as a new list, the flat container may request  a  change  in
geometry from its parent.  Note:
It is not necessary to use this resource if the  application
modifies the list with the OlFlatSetValues procedure; nor is
it necessary to use this resource whenever  the  application
supplies a new list to the flat container.

XtNlabel This is the text string that appears in the sub-object.

XtNlabelImage This is an XImage pointer that can appear in a sub-object. This resource is ignored if XtNlabel is non-NULL.

XtNlabelJustify Range of Values:

OL_LEFT/"left"
OL_CENTER/"center"
OL_RIGHT/"right"

This resource specifies the justification of the label or XImage that appears within a sub-object.

XtNlabelTile Range of values:

TRUE
FALSE

This resource augments the XtNlabelImage/XtNlabelPixmap resource to allow tiling of the sub-object's background. For an image/pixmap that is smaller than the sub-object's background, the label area is tiled with the image/pixmap to fill the sub-object's background if this resource is TRUE; otherwise, the label is placed as described by the XtNlabel-Justify resource. The XtNlabelTile resource is ignored for text labels.

XtNmappedWhenManaged Range of Values:

                TRUE/"true"
                FALSE/"false"

This resource specifies whether or not a managed  sub-object
is  displayed.   Regardless  of  this  resource's value, all
managed sub-objects will be included  when  determining  the
layout.  Note:
This resource is never inherited from the container, so  its
default value is always TRUE.

XtNnumItems This resource specifies the number of sub-object items.

XtNnumItemFields This resource indicates the number of resource names contained in XtNitemFields.

XtNposition Range of Values:

OL_LEFT/"left"
OL_RIGHT/"right"

This resource determines on which side of the check box the label is to be placed. The value of OL_LEFT or OL_RIGHT indicates the label is placed to the left or to the right of the check box, respectively.

XtNsameHeight Range of Values:

OL_ALL/"all"
OL_ROWS/"rows"
OL_NONE/"none"

This resource specifies the rows that are forced to the same height.

XtNsameWidth Range of Values:

OL_ALL/"all"
OL_COLUMNS/"columns"
OL_NONE/"none"

This resource specifies the columns that are forced to the same width.

XtNselectProc This callback procedure is called whenever the sub-object becomes selected by user input.

XtNsensitive Range of Values:

TRUE/"true"
FALSE/"false"

If TRUE, the sub-object is sensitive to user input. If FALSE, the sub-object is insensitive to user input and an inactive visual is displayed to indicate this state. Note: This resource is never inherited from the container, so its default value is always TRUE.

XtNset Range of Values:

                TRUE/"true"
                FALSE/"false"

This resource reflects the current state of the  sub-object.
Note:
This resource is never inherited from the container, so  its
default value is always FALSE.  Even if the application does
not use XtNset in its item fields list, the  container  will
correctly  maintain  the  set  item  and the application can
change the set item via OlFlatSetValues.

XtNunselectProc This callback procedure is called whenever the sub-object becomes unselected by user input.