Museum

 XmOptionButtonGadget(Xm)       6 January 1993       XmOptionButtonGadget(Xm)


 Name

    XmOptionButtonGadget - a RowColumn function that obtains the widget ID
    for the CascadeButtonGadget in an OptionMenu

 Syntax


    #include <Xm/RowColumn.h>

    Widget XmOptionButtonGadget (option_menu)
    Widget option_menu;


 Description

    XmOptionButtonGadget provides the application with the means for obtain-
    ing the widget ID for the internally created CascadeButtonGadget. Once
    the application has obtained the widget ID, it can adjust the visuals for
    the CascadeButtonGadget, if desired.

    When an application creates an instance of the OptionMenu widget, the
    widget creates two internal gadgets. One is a LabelGadget that is used to
    display RowColumn's XmNlabelString resource.  The other is a
    CascadeButtonGadget that displays the current selection and provides the
    means for posting the OptionMenu's submenu.

    The user can specify resources in a resource file for the automatically
    created widgets and gadgets of an OptionMenu. The following list identi-
    fies the names of these widgets (or gadgets) and the associated Option-
    Menu areas.

    +  Option Menu Label Gadget -- ``OptionLabel''

    +  Option Menu Cascade Button -- ``OptionButton''

    optionmenu
            Specifies the OptionMenu widget ID

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

 Return value

    Returns the widget ID for the internal button.

 See also

    XmCreateOptionMenu(Xm), XmCascadeButtonGadget(Xm),
    XmOptionLabelGadget(Xm) and XmRowColumn(Xm).