Museum

 XmOptionLabelGadget(Xm)        6 January 1993        XmOptionLabelGadget(Xm)


 Name

    XmOptionLabelGadget - a RowColumn function that obtains the widget ID for
    the LabelGadget in an OptionMenu

 Syntax


    #include <Xm/RowColumn.h>

    Widget XmOptionLabelGadget (option_menu)
    Widget option_menu;


 Description

    XmOptionLabelGadget provides the application with the means for obtaining
    the widget ID for the internally created LabelGadget.  Once the applica-
    tion has obtained the widget ID, it can adjust the visuals for the Label-
    Gadget, 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 label.

 See also

    XmCreateOptionMenu(Xm), XmLabelGadget(Xm), XmOptionButtonGadget(Xm) and
    XmRowColumn(Xm).