XmCreatePulldownMenu(3X)

     NAME
          XmCreatePulldownMenu - A RowColumn widget convenience
          creation function

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

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          XmCreatePulldownMenu creates an instance of a RowColumn
          widget of type XmMENU_PULLDOWN and returns the associated
          widget ID.

          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)

          Specifies the number of attribute/value pairs in the
          argument list (arglist).  When this function is used to
          create the Pulldown menu pane, a MenuShell widget is
          automatically created as the parent of the menu pane. If the
          widget specified by the parent parameter is a Popup or a
          Pulldown menu pane, the MenuShell widget is created as a
          child of the parent 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 menu panes and is not implemented as a separate
          widget class.

          A Pulldown 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.

          A Pulldown menu pane is used with submenus that are to be
          attached to a CascadeButton or a CascadeButtonGadget. This
          is the case for all menu panes that are part of a
          PulldownMenu system (a MenuBar), the menu pane associated
          with an OptionMenu, and any menu panes that cascade from a
          Popup menu pane. Pulldown menu panes that are to be
          associated with an OptionMenu must be created before the
          OptionMenu is created.

          The Pulldown menu pane must be attached to a CascadeButton
          or CascadeButtonGadget that resides in a MenuBar, a Popup
          menu pane, a Pulldown menu pane, or an OptionMenu. It is
          attached with the button resource XmNsubMenuId.

          A MenuShell widget is required between the Pulldown menu
          pane and its parent.  If the application uses this
          convenience function for creating a Pulldown menu pane, the
          MenuShell is automatically created as the real parent of the
          menu pane; otherwise, it is the application's responsibility
          to create the MenuShell widget.

          To function correctly when incorporated into a menu, the
          Pulldown menu pane's hierarchy must be considered. This
          hierarchy depends on the type of menu system that is being
          built, as follows:

             o  If the Pulldown menu pane is to be pulled down from a
                MenuBar, its parentmust be the MenuBar.

             o  If the Pulldown menu pane is to be pulled down from a
                Popup or another Pulldown menu pane, its parent must
                be that Popup or Pulldown menu pane.

             o  If the Pulldown menu pane is to be pulled down from an
                OptionMenu, its parent must be the same as the
                OptionMenu parent.

          PullDown 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
          XmCascadeButton(3), XmCascadeButtonGadget(3),
          XmCreateOptionMenu(3), XmCreatePopupMenu(3),
          XmCreateSimplePulldownMenu(3), XmMenuShell(3),
          XmRowColumn(3), and XmVaCreateSimplePulldownMenu(3).