XmCreatePopupMenu(3X)

     NAME
          XmCreatePopupMenu - A RowColumn widget convenience creation
          function

     SYNOPSIS
          #include <Xm/RowColumn.h>
          Widget XmCreatePopupMenu(
          Widget parent,
          String name,
          ArgList arglist,
          Cardinal argcount);

     VERSION
          This page documents Motif 2.1.

     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 XmRowColumnresources.  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).