XmOptionLabelGadget(X3mot)

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

Synopsis

#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 application has obtained the widget ID, it can adjust the visuals for the LabelGadget, 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''
Specifies the OptionMenu widget ID

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

Return values

Returns the widget ID for the internal label.

References

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