XmCreatePulldownMenu(X3mot)


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:

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(X3mot).

Return values

Returns the RowColumn widget ID.

References

XmCascadeButton(X3mot), XmCascadeButtonGadget(X3mot),
XmCreateOptionMenu(X3mot), XmCreatePopupMenu(X3mot),
XmCreateSimplePulldownMenu(X3mot), XmMenuShell(X3mot), XmRowColumn(X3mot) and XmVaCreateSimplePulldownMenu(X3mot).
25 April 2004
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004