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.

RELATED

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

                                                                             XmCreatePopupMenu(3)