DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

XmCreateRadioBox(Xm)


XmCreateRadioBox -- a RowColumn widget convenience creation function

Syntax

#include <Xm/RowColumn.h>

Widget XmCreateRadioBox (parent, name, arglist, argcount) Widget parent; String name; ArgList arglist; Cardinal argcount;

Description

XmCreateRadioBox creates an instance of a RowColumn widget of type XmWORK_AREA and returns the associated widget ID. Typically, this is a composite widget that contains multiple ToggleButtonGadgets. The RadioBox arbitrates and ensures that at most one ToggleButtonGadget is on at any time.

Unless the application supplies other values in the arglist, this function provides initial values for several RowColumn resources. It initializes XmNpacking to XmPACK_COLUMN, XmNradioBehavior to True, XmNisHomogeneous to True, and XmNentryClass to xmToggleButtonGadgetClass.

In a RadioBox the ToggleButton or ToggleButtonGadget resource XmNindicatorType defaults to XmONE_OF_MANY, and the ToggleButton or ToggleButtonGadget resource XmNvisibleWhenOff defaults to True.

This routine is provided as a convenience function for creating RowColumn widgets.


parent
Specifies the parent widget ID

name
Specifies the name of the created widget

arglist
Specifies the argument list

argcount
Specifies the number of attribute/value pairs in the argument list (arglist)

For a complete definition of RowColumn and its associated resources, see XmRowColumn(Xm).

Return value

Returns the RowColumn widget ID.

See also

XmCreateRowColumn(Xm), XmCreateSimpleCheckBox(Xm),
XmCreateSimpleRadioBox(Xm), XmCreateWorkArea(Xm), XmRowColumn(Xm), XmVaCreateSimpleCheckBox(Xm)
and XmVaCreateSimpleRadioBox(Xm).
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003