XmCreatePulldownMenu(library call) XmCreatePulldownMenu(library call)

NAME

XmCreatePulldownMenu -- A RowColumn widget convenience creation
function

SYNOPSIS

#include <Xm/RowColumn.h>
Widget XmCreatePulldownMenu(
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.

parent Specifies the parent widget ID

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)

Specifies the number of attribute/value pairs in the argument list
(arglist). When this function is used to create the Pulldown menu
pane, a MenuShell widget is automatically created as the parent of
the menu pane. If the widget specified by the parent parameter is a
Popup or a Pulldown menu pane, the MenuShell widget is created as a
child of the parent 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 menu
panes and is not implemented as a separate widget class.

A Pulldown menu pane displays a 3-D shadow, unless the feature is
disabled by the application. The shadow appears around the edge of
the menu pane.

A Pulldown menu pane is used with submenus that are to be attached to
a CascadeButton or a CascadeButtonGadget. This is the case for all
menu panes that are part of a PulldownMenu system (a MenuBar), the
menu pane associated with an OptionMenu, and any menu panes that
cascade from a Popup menu pane. Pulldown menu panes that are to be
associated with an OptionMenu must be created before the OptionMenu
is created.

The Pulldown menu pane must be attached to a CascadeButton or
CascadeButtonGadget that resides in a MenuBar, a Popup menu pane, a
Pulldown menu pane, or an OptionMenu. It is attached with the button
resource XmNsubMenuId.

A MenuShell widget is required between the Pulldown menu pane and its
parent. If the application uses this convenience function for
creating a Pulldown menu pane, the MenuShell is automatically created
as the real parent of the menu pane; otherwise, it is the
application's responsibility 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:

+o If the Pulldown menu pane is to be pulled down from a MenuBar,
its parent must be the MenuBar.

+o If the Pulldown menu pane is to be pulled down from a Popup or
another Pulldown menu pane, its parent must be that Popup or
Pulldown menu pane.

+o If the Pulldown menu pane is to be pulled down from an
OptionMenu, its parent must be the same as the OptionMenu
parent.

PullDown menu panes support tear-off capabilities for tear-off menus
through XmRowColumn resources. For a complete definition of
RowColumn and its associated resources, see XmRowColumn(3).

RETURN

Returns the RowColumn widget ID.

RELATED

XmCascadeButton(3), XmCascadeButtonGadget(3), XmCreateOptionMenu(3),
XmCreatePopupMenu(3), XmCreateSimplePulldownMenu(3), XmMenuShell(3),
XmRowColumn(3), and XmVaCreateSimplePulldownMenu(3).

XmCreatePulldownMenu(library call)