[Contents] [Index] [Next] [Previous]

XmCreateSimplePulldownMenu


NAME

XmCreateSimplePulldownMenu - A RowColumn widget convenience creation function

SYNOPSIS

#include <Xm/RowColumn.h>
Widget XmCreateSimplePulldownMenu (parent, name, arglist, argcount)
      Widget    parent;
      String    name;
      ArgList   arglist;
      Cardinal  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 MenuPane and its button 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. The name of each title is label_n, where n is an integer from 0 to one minus the number of titles in the menu. Buttons, separators, and titles are named and created in the order in which 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(3X).

RETURN VALUE

Returns the RowColumn widget ID.

RELATED INFORMATION

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