XmCreatePopupMenu(3X) X11 SDE 5.4R3.00 XmCreatePopupMenu(3X)
NAME
XmCreatePopupMenu--A RowColumn widget convenience creation function
SYNOPSIS
#include <Xm/RowColumn.h>
Widget XmCreatePopupMenu (parent, name, arglist, argcount)
Widget parent; String name; ArgList arglist;
Cardinal argcount;
DESCRIPTION
XmCreatePopupMenu creates an instance of a RowColumn widget of type
XmMENU_POPUP and returns the associated widget ID. When using this
function to create the Popup MenuPane, a MenuShell widget is
automatically created as the parent of the MenuPane. The parent of
the MenuShell widget is the widget indicated by the parent parameter.
XmCreatePopupMenu is provided as a convenience function for creating
RowColumn widgets configured to operate as Popup MenuPanes and is not
implemented as a separate widget class.
The PopupMenu is used as the first MenuPane within a PopupMenu
system; all other MenuPanes are of the Pulldown type. A Popup
MenuPane displays a 3-D shadow, unless the feature is disabled by the
application. The shadow appears around the edge of the MenuPane.
The Popup MenuPane must be created as the child of a MenuShell widget
in order to function properly when it is incorporated into a menu.
If the application uses this convenience function for creating a
Popup MenuPane, the MenuShell is automatically created as the real
parent of the MenuPane. If the application does not use this
convenience function to create the RowColumn to function as a Popup
MenuPane, it is the application's responsibility to create the
MenuShell widget.
To access the PopupMenu, the application must first position the
widget using the XmMenuPosition function and then manage it using
XtManageChild.
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)
Popup MenuPanes support tear-off capabilities for tear-off menus
through XmRowColumn resources. For a complete definition of
Licensed material--property of copyright holder(s) 1
XmCreatePopupMenu(3X) X11 SDE 5.4R3.00 XmCreatePopupMenu(3X)
RowColumn and its associated resources, see XmRowColumn(3X).
RETURN VALUE
Returns the RowColumn widget ID.
RELATED INFORMATION
XmCreateSimplePopupMenu(3X), XmMenuPosition(3X), XmMenuShell(3X),
XmRowColumn(3X), and XmVaCreateSimplePopupMenu(3X).
Licensed material--property of copyright holder(s) 2