WIDGET CLASS NAME

Nonexclusives

SYNOPSIS

#include <Intrinsic.h>
#include <StringDefs.h>
#include <OpenLook.h>
#include <Nonexclusi.h>
widget = XtCreateWidget(name, nonexclusivesWidgetClass, ...);

DESCRIPTION

The Nonexclusives widget provides a simple way to build a several-of-many button selection object. It manages a set of rectangular buttons or check boxes, providing layout management and selection control.

Grid Layout and Button Labels The Nonexclusives widget  lays
out  the rectangular buttons or check boxes in a grid in the
order they are added as child widgets  by  the  application.
The number of rows or columns in this grid can be controlled
by the application.  If the grid has more than one row,  the
Nonexclusives widget forces the rectangular buttons or check
boxes in each column to be the same size as  the  widest  in
the  column.  (Note:  If the grid is a single row, each but-
ton will be only as wide as necessary to display the label.)
The  rectangular  buttons  or check boxes are separated by a
distance that is 50% of the prevailing point  size  for  the
containing window.
         Figure 1.  Example of Nonexclusive Buttons

Use in a Menu The Nonexclusives widget can be added as a single child to a menu pane to implement a several-of-many menu choice. Only RectButton widgets can be used in a Nonexclusives widget in a menu.

Child Constraint The Nonexclusives widget constrains its child widgets to be of class rectButtonWidgetClass or check-BoxWidgetClass. Additionally, all the child widgets must be of the same class.

Nonexclusives Coloration There is no explicit foreground or background in the Nonexclusives composite widget; each rectangular button has its own foreground and background. The space between the rectangular buttons or check boxes is the same color or pixmap as the parent of the Nonexclusives widget.

Amiga Unix                Last change:                          1

RESOURCES

     ______________________________________________________________________________________
     ___________________________Nonexclusives_Resource_Set\*(cO____________________________
      Name                   Class                  Type             Default        Access
     ______________________________________________________________________________________

Amiga Unix                Last change:                          2
()                MISC. REFERENCE MANUAL PAGES                 ()

     ______________________________________________________________________________________
     _XtNancestorSensitive___XtCSenstitive__________Boolean__________TRUE___________G*_____
    | XtNdepth               XtCDepth               int              (parent's)     GI    |
    |_____________________|______________________|________________|______________|________|
    |_XtNdestroyCallback__|__XtCCallback_________|__XtCallbackList|__NULL________|__SI____|
    | XtNheight           |  XtCHeight           |  Dimension     |  (calculated)|  SGI   |
    |_____________________|______________________|________________|______________|________|
    |_XtNlayoutType_______|__XtCLayoutType_______|__OlDefine______|__OL_FIXEDROWS|__SGI___|
    | XtNmappedWhenManaged|  XtCMappedWhenManaged|  Boolean       |  TRUE        |  SGI   |
    |_____________________|______________________|________________|______________|________|
    |_XtNmeasure__________|__XtCMeasure__________|__int___________|__1___________|__SGI___|
    | XtNsensitive        |  XtCSensitive        |  Boolean       |  TRUE        |  GI*   |
    |_____________________|______________________|________________|______________|________|
    |_XtNuserData_________|__XtCUserData_________|__XtPointer_____|__NULL________|__SGI___|
    | XtNwidth            |  XtCWidth            |  Dimension     |  (calculated)|  SGI   |
    |_____________________|______________________|________________|______________|________|
    |_XtNx________________|__XtCPosition_________|__Position______|__0___________|__SGI___|
    | XtNy                |  XtCPosition         |  Position      |  0           |  SGI   |
    |_____________________|______________________|________________|______________|________|
     XtNlayoutType

     Range of Values:
          OL_FIXEDROWS/"fixedrows"
          OL_FIXEDCOLS/"fixedcols"

This resource controls the type of layout of the child widgets by the Nonexclusives composite. The choices are to specify the number of rows or the number of columns. Only one of these dimensions can be specified directly; the other is determined by the number of child widgets added, and will always be enough to show all the child widgets. The values of the XtNlayoutType resource can be

OL_FIXEDROWS if the layout should have a fixed number of rows;

OL_FIXEDCOLS if the layout should have a fixed number of columns.

                    XtNmeasure

     Range of Values:
          0 < XtNmeasure
     This resource gives the number of rows  or  columns  in  the
     layout  of the child widgets.  If there are not enough child
     widgets to fill a row or column, the remaining space is left
     blank.   If  there  is  only one row (column), and it is not
     filled with child widgets, the  remaining  ``space''  is  of
     zero width (height).

Amiga Unix                Last change:                          1