NAME

       XmOptionButtonGadget  — A RowColumn function that obtains the widget ID for the CascadeButtonGadget in an
       OptionMenu "XmOptionButtonGadget" "RowColumn functions" "XmOptionButtonGadget"

SYNOPSIS

       #include <Xm/RowColumn.h>
       Widget XmOptionButtonGadget(
       Widget option_menu);

DESCRIPTION

       XmOptionButtonGadget provides the application with  the  means  for  obtaining  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  identifies  the names of these widgets (or gadgets) and the associated
       OptionMenu areas.

       Option Menu Label Gadget
                 OptionLabel

       Option Menu Cascade Button
                 OptionButton

       option_menu
                 Specifies the OptionMenu widget ID

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

RETURN

       Returns the widget ID for the internal button.

RELATED

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

                                                                                         XmOptionButtonGadget(3)