XmCreateSimplePulldownMenu

Motif 2.1 Programmer's Reference

XmCreateSimplePulldownMenu

A RowColumn widget convenience creation function

Format

#include <Xm/RowColumn.h>
Widget XmCreateSimplePulldownMenu
Widget
parentString nameArgList
arglistCardinal argcount

DESCRIPTION

XmCreateSimplePulldownMenu creates an instance of a RowColumn widget of type XmMENU_PULLDOWN and returns the associated widget ID.

This routine creates a Pulldown menu pane and its button children. The name of each button is button_ n, where n is an integer from 0 (zero) to the number of buttons in the menu minus 1. The name of each separator is separator_ n, where n is an integer from 0 (zero) to the number of separators in the menu minus 1. The name of each title is label_ n, where n is an integer from 0 (zero) to the number of titles in the menu minus 1. Buttons, separators, and titles are named and created in the order they are specified in the RowColumn simple menu creation resources supplied in the argument list.

parent

Specifies the widget ID of the parent of the MenuShell

name

Specifies the name of the created widget

arglist

Specifies the argument list

argcount

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

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 XmCASCADEBUTTON, XmPUSHBUTTON, XmRADIOBUTTON, XmCHECKBUTTON, XmTITLE, XmSEPARATOR, and XmDOUBLE_SEPARATOR. For a complete definition of RowColumn and its associated resources, see XmRowColumn (3).

RETURN

Returns the RowColumn widget ID.

RELATED

XmCreatePulldownMenu (3), XmCreateRowColumn (3), XmRowColumn (3), and XmVaCreateSimplePulldownMenu (3).