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 button 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.  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 checkBoxWidgetClass.  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. 
 

RESOURCES

Nonexclusives Resource Set\\∗(cO
                Name            Type       Default  Access XtNancestorSensitive         Boolean          TRUE      G∗
            XtNdepth             int    (parent’s)      GI
  XtNdestroyCallback  XtCallbackList          NULL      SI
           XtNheight       Dimension  (calculated)     SGI XtNmappedWhenManaged         Boolean          TRUE     SGI
          XtNmeasure             int             1     SGI
        XtNsensitive         Boolean          TRUE     GI∗
         XtNuserData       XtPointer          NULL     SGI
            XtNwidth       Dimension  (calculated)     SGI
                XtNx        Position             0     SGI
                XtNy        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). 

Sun Release 4.0  —  Last change: 1/8/90