xmmenuposition(3) [hpux man page]

XmMenuPosition(library call)											      XmMenuPosition(library call)

NAME

       XmMenuPosition -- A RowColumn function that positions a Popup menu pane

SYNOPSIS

       #include <Xm/RowColumn.h>
       void XmMenuPosition(
       Widget menu,
       XButtonPressedEvent * event);

DESCRIPTION

       XmMenuPosition positions a Popup menu pane using the information in the specified event. Unless an application is positioning the menu pane
       itself, it must first invoke this function before managing the PopupMenu.  The x_root and y_root fields in the specified X event  are  used
       to determine the menu position.

       menu	 Specifies the PopupMenu to be positioned

       event	 Specifies the event passed to the action procedure which manages the PopupMenu

       Which  corner  of  the PopupMenu is positioned at the x_root and y_root depends on the XmNlayoutDirection resource of the widget from which
       popup occurs.

       For a complete definition of RowColumn and its associated resources, see XmRowColumn(3).

RELATED

       XmRowColumn(3).

														      XmMenuPosition(library call)

XmCreatePopupMenu(library call) 										   XmCreatePopupMenu(library call)

NAME

       XmCreatePopupMenu -- A RowColumn widget convenience creation function

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  XtMan-
       ageChild.

       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.

RELATED

       XmCreateSimplePopupMenu(3), XmMenuPosition(3), XmMenuShell(3), XmRowColumn(3), and XmVaCreateSimplePopupMenu(3).

														   XmCreatePopupMenu(library call)