XmOptionButtonGadget(3X)

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

SYNOPSIS
     #include <Xm/RowColumn.h>

     Widget XmOptionButtonGadget (option_menu)
          Widget    option_menu;


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmOptionButtonGadget provides the application with the means for  obtaining
     the widget ID for the internally created CascadeButtonGadget.  Once the ap-
     plication  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  wid-
     get  creates  two  internal  gadgets.  One is a LabelGadget that is used to
     display RowColumn's XmNlabelString resource.  The other is a CascadeButton-
     Gadget that displays the current selection and provides the means for post-
     ing 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  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(3X).

RETURN VALUE
     Returns the widget ID for the internal button.

RELATED INFORMATION
     XmCreateOptionMenu(3X), XmCascadeButtonGadget(3X), XmOptionLabelGadget(3X),
     and XmRowColumn(3X).

                                                        XmOptionButtonGadget(3X)