'\"!  tbl | tbl | tbl | tbl | tbl | tbl | tbl | tbl | tbl | tbl | tbl | tbl | tbl | eqn | tbl | tbl | tbl | tbl | mmdoc
'\"macro stdmacro
.if n .pH g3w.olNxclusives @(#)olNxclusives	40.3 of 1/8/90
.SO BP.HEADER \" This header enables use of .BP macro for PostScript graphics
.ig
Modified by lmh 10/18/89
..
.ds cW NONEXCLUSIVES
.ds rW Nonexclusives
.ds nW Nonexclusi
.ds wW nonexclusives
.ds bW \fB\*(rW\fP
.ds iW \fI\*(rW\fP
.ds oS \*(cW
.nr oN 0
.nr X
.if \nX=0 .ds x} ""NONEXCLUSIVE SETTINGS WIDGET" 3W "\&"
.if \nX=1 .ds x} ""NONEXCLUSIVE SETTINGS WIDGET" 3W
.if \nX=2 .ds x} ""NONEXCLUSIVE SETTINGS "" "\&"
.if \nX=3 .ds x} ""NONEXCLUSIVE "" "" "\&"
.TH \*(x}
.SH "WIDGET CLASS NAME"
\*(bW
.SH "SYNOPSIS"
.nf
\s-1\f4#include <Intrinsic.h>
#include <StringDefs.h>
#include <OpenLook.h>
#include <\*(nW.h>\f1\s+1\f1
.fi
.P
.nf
\s-1\f4widget = XtCreateWidget(\f2name\f4, \*(wWWidgetClass, ...);\f1\s+1
.fi
.SH "DESCRIPTION"
The \*(bW 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.
.sp
\f3Grid Layout and Button Labels\f1
.P
The \*(bW 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 \*(bW 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.)
.P
The rectangular buttons or check boxes are separated by a
distance that is 50% of the prevailing point size for the
containing window.
.br
.ne3.5i
.BP PSART/ps.nonex1
.P
.ce
\f3Figure 1.\f1  Example of Nonexclusive Buttons
.sp
\f3Use in a Menu\f1
.P
The \*(bW widget can be added as a single child to a menu pane
to implement a several-of-many menu choice.
Only
\f3RectButton\f1
widgets can be used in a \*(bW widget in a menu.
.sp
\f3Child Constraint\f1
.P
The \*(bW widget constrains its child widgets to be of
class
\f3rectButtonWidgetClass\f1
or
\f3checkBoxWidgetClass\f1.
Additionally,
all the child widgets must be of the same class.
.sp
\f3\*(rW Coloration\f1
.P
There is no explicit foreground or background in the \*(bW
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 \*(bW widget.
.bp
.SH "RESOURCES"
.ds cO
.TS H
allbox;
cB s s s s.
\*(bW Resource Set\\\\*(cO
.T&
lBp-2 lBp-2 lBp-2 lBp-2 lBp-2.
Name	Class	Type	Default	Access
_
.TH
.ds cO " (cont'd)
.T&
lp-2 lp-2 lp-2 lp-2 lp-2.
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
.TE
\f3XtNlayoutType\f1
.PP
Range of Values:
.br
.in +5
.nf
\f4OL_FIXEDROWS/"fixedrows"
OL_FIXEDCOLS/"fixedcols"\f1
.in -5
.fi
.PP
This resource controls the type of layout of the child widgets
by the \*(bW 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.
.P
The values of the
\f4XtNlayoutType\f1
resource can be
.IP \f4OL_FIXEDROWS\f1 15
if the layout should have a fixed number of rows;
.IP \f4OL_FIXEDCOLS\f1 15 
if the layout should have a fixed number of columns.
.P
.sp
\f3XtNmeasure\f1
.PP
Range of Values:
.br
.in +5
\f40 < XtNmeasure\f1
.in -5
.P
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).
.P
