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;


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmCreatePopupMenu  creates  an  instance  of a RowColumn widget of type Xm-
     MENU_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 Row-
     Column widgets configured to operate as Popup MenuPanes and is  not  imple-
     mented 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 ap-
     pears 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 ap-
     plication 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  Row-
     Column  to  function as a Popup MenuPane, it is the application's responsi-
     bility to create the MenuShell widget.

     To access the PopupMenu, the application must first position the widget us-
     ing the XmMenuPosition function and then manage it using XtManageChild.


     parent Specifies the parent widget ID

     name   Specifies the name of the created widget

     arglistSpecifies 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 RowColumn and its  as-
     sociated resources, see XmRowColumn(3X).

RETURN VALUE
     Returns the RowColumn widget ID.

RELATED INFORMATION
     XmCreateSimplePopupMenu(3X), XmMenuPosition(3X), XmMenuShell(3X), XmRowCol-
     umn(3X), and XmVaCreateSimplePopupMenu(3X).

                                                           XmCreatePopupMenu(3X)