NAME

XmCreateSimpleOptionMenu—A RowColumn widget convenience creation function

SYNOPSIS

#include <Xm/RowColumn.h>
Widget XmCreateSimpleOptionMenu (parent, name, arglist, argcount)
Widgetparent;
Stringname;
ArgListarglist;
Cardinalargcount;

DESCRIPTION

XmCreateSimpleOptionMenu creates an instance of a RowColumn widget of type XmMENU_OPTION and returns the associated widget ID. 

This routine creates an Option Menu and its submenu containing PushButtonGadget or CascadeButtonGadget children.  The name of each button is button_n, where n is an integer from 0 to one minus the number of buttons in the menu.  The name of each separator is separator_n, where n is an integer from 0 to one minus the number of separators in the menu.  Buttons and separators are named and created in the order in which they are specified in the RowColumn simple menu creation resources supplied in the argument list. 

parentSpecifies the parent widget ID

nameSpecifies the name of the created widget

arglistSpecifies the argument list

argcountSpecifies the number of attribute/value pairs in the argument list (arglist)

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"

A number of resources exist specifically for use with this and other simple menu creation routines.  The only button types allowed in the XmNbuttonType resource are XmPUSHBUTTON, XmCASCADEBUTTON, XmSEPARATOR, and XmDOUBLE_SEPARATOR.  For a complete definition of RowColumn and its associated resources, see XmRowColumn(3X). 

RETURN VALUE

Returns the RowColumn widget ID. 

RELATED INFORMATION

XmCreateOptionMenu(3X), XmCreateRowColumn(3X), XmRowColumn(3X), and XmVaCreateSimpleOptionMenu(3X). 

Sun Release 4.0  —  Last change: