NAME¶
XmCreatePopupMenu — A RowColumn widget convenience creation
function "XmCreatePopupMenu" "creation functions"
"XmCreatePopupMenu"
SYNOPSIS¶
#include <Xm/RowColumn.h>
Widget XmCreatePopupMenu(
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 this function
is used to create the Popup menu pane, a MenuShell widget is automatically
created as the parent of the menu pane. 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 menu panes and is not
implemented as a separate widget class.
The PopupMenu is used as the first menu pane within a PopupMenu system; all
other menu panes are of the Pulldown type. A Popup 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.
The Popup menu pane 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 menu pane, the MenuShell
is automatically created as the real parent of the menu pane. If the
application does not use this convenience function to create the RowColumn to
function as a Popup menu pane, 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 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.
XmCreateSimplePopupMenu(3),
XmMenuPosition(3),
XmMenuShell(3),
XmRowColumn(3), and
XmVaCreateSimplePopupMenu(3).