XmCreatePulldownMenu(3X)XmCreatePulldownMenu(3X)NAMEXmCreatePulldownMenu - A RowColumn widget convenience creation function
SYNOPSIS
#include <Xm/RowColumn.h>
Widget XmCreatePulldownMenu (parent, name, arglist, argcount)
Widget parent;
String name;
ArgList arglist;
Cardinal argcount;
DESCRIPTIONXmCreatePulldownMenu creates an instance of a RowColumn widget of type
XmMENU_PULLDOWN and returns the associated widget ID. When using this
function to create the Pulldown MenuPane, a MenuShell widget is auto‐
matically created as the parent of the MenuPane. If the widget speci‐
fied by the parent parameter is a Popup or a Pulldown MenuPane, the
MenuShell widget is created as a child of the parent's MenuShell; oth‐
erwise, it is created as a child of the specified parent widget.
XmCreatePulldownMenu is provided as a convenience function for creating
RowColumn widgets configured to operate as Pulldown MenuPanes and is
not implemented as a separate widget class.
A Pulldown MenuPane displays a 3-D shadow, unless the feature is dis‐
abled by the application. The shadow appears around the edge of the
MenuPane.
A Pulldown MenuPane is used when creating submenus that are to be
attached to a CascadeButton or a CascadeButtonGadget. This is the case
for all MenuPanes that are part of a PulldownMenu system (a MenuBar),
the MenuPane associated with an OptionMenu, and any MenuPanes that cas‐
cade from a Popup MenuPane. Pulldown MenuPanes that are to be associ‐
ated with an OptionMenu must be created before the OptionMenu is cre‐
ated.
The Pulldown MenuPane must be attached to a CascadeButton or Cascade‐
ButtonGadget that resides in a MenuBar, a Popup MenuPane, a Pulldown
MenuPane, or an OptionMenu. This is done by using the button resource
XmNsubMenuId.
A MenuShell widget is required between the Pulldown MenuPane and its
parent. If the application uses this convenience function for creating
a Pulldown MenuPane, the MenuShell is automatically created as the real
parent of the MenuPane; otherwise, it is the application's responsibil‐
ity to create the MenuShell widget.
To function correctly when incorporated into a menu, the Pulldown Menu‐
Pane's hierarchy must be considered; this hierarchy depends on the type
of menu system that is being built as follows: If the Pulldown MenuPane
is to be pulled down from a MenuBar, its parent must be the MenuBar.
If the Pulldown MenuPane is to be pulled down from a Popup or another
Pulldown MenuPane, its parent must be that Popup or Pulldown MenuPane.
If the Pulldown MenuPane is to be pulled down from an OptionMenu, its
parent must be the same as the OptionMenu parent. Specifies the parent
widget ID Specifies the name of the created widget Specifies the argu‐
ment list Specifies the number of attribute/value pairs in the argument
list (arglist)
PullDown MenuPanes support tear-off capabilities for tear-off menus
through XmRowColumn resources. For a complete definition of RowColumn
and its associated resources, see XmRowColumn(3X).
RETURN VALUE
Returns the RowColumn widget ID.
SEE ALSOXmCascadeButton(3X), XmCascadeButtonGadget(3X), XmCreateOptionMenu(3X),
XmCreatePopupMenu(3X), XmCreateSimplePulldownMenu(3X), XmMenuShell(3X),
XmRowColumn(3X), XmVaCreateSimplePulldownMenu(3X)XmCreatePulldownMenu(3X)