Museum

 XmCreateRadioBox(Xm)           6 January 1993           XmCreateRadioBox(Xm)


 Name

    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
    XmWORKAREA 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 func-
    tion provides initial values for several RowColumn resources.  It ini-
    tializes XmNpacking to XmPACKCOLUMN, XmNradioBehavior to True, XmNis-
    Homogeneous to True, and XmNentryClass to xmToggleButtonGadgetClass.

    In a RadioBox the ToggleButton or ToggleButtonGadget resource XmNindica-
    torType defaults to XmONEOFMANY, and the ToggleButton or ToggleBut-
    tonGadget 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).