XmCreatePulldownMenu(3X) X11 SDE 5.4R3.00 XmCreatePulldownMenu(3X)
NAME
XmCreatePulldownMenu--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;
DESCRIPTION
XmCreatePulldownMenu 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 automatically created as the parent of the MenuPane. If the
widget specified by the parent parameter is a Popup or a Pulldown
MenuPane, the MenuShell widget is created as a child of the parent's
MenuShell; otherwise, 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
disabled 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 cascade from a Popup MenuPane. Pulldown MenuPanes
that are to be associated with an OptionMenu must be created before
the OptionMenu is created.
The Pulldown MenuPane must be attached to a CascadeButton or
CascadeButtonGadget 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 responsibility to create the MenuShell widget.
To function correctly when incorporated into a menu, the Pulldown
MenuPane'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,
Licensed material--property of copyright holder(s) 1
XmCreatePulldownMenu(3X) X11 SDE 5.4R3.00 XmCreatePulldownMenu(3X)
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 argument 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.
RELATED INFORMATION
XmCascadeButton(3X), XmCascadeButtonGadget(3X),
XmCreateOptionMenu(3X), XmCreatePopupMenu(3X),
XmCreateSimplePulldownMenu(3X), XmMenuShell(3X), XmRowColumn(3X), and
XmVaCreateSimplePulldownMenu(3X).
Licensed material--property of copyright holder(s) 2