Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xmcreatepopupmenu(3x) [osf1 man page]

XmCreatePopupMenu(3X)													     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 dis- plays 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 XtMan- ageChild. 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) Popup 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. SEE ALSO
XmCreateSimplePopupMenu(3X), XmMenuPosition(3X), XmMenuShell(3X), XmRowColumn(3X), XmVaCreateSimplePopupMenu(3X) XmCreatePopupMenu(3X)

Check Out this Related Man Page

XmCreatePulldownMenu(3X)												  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 respon- sibility 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, 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 Pull- down 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. SEE ALSO
XmCascadeButton(3X), XmCascadeButtonGadget(3X), XmCreateOptionMenu(3X), XmCreatePopupMenu(3X), XmCreateSimplePulldownMenu(3X), XmMenuShell(3X), XmRowColumn(3X), XmVaCreateSimplePulldownMenu(3X) XmCreatePulldownMenu(3X)
Man Page

Featured Tech Videos