XmCreatePulldownMenu(3X)

     NAME
          XmCreatePulldownMenu - A RowColumn widget convenience
          creation function

     SYNOPSIS
          #include <Xm/RowColumn.h>

          Widget XmCreatePulldownMenu (parent, name, arglist, argcount)
               Widget    parent;
               String    name;
               ArgList   arglist;
               Cardinal  argcount;


     VERSION
          This page documents version 1.2 of the Motif library.

     DESCRIPTION
          XmCreatePulldownMenu creates an instance of a RowColumn
          widget of type XmMENU_PULLDOWN and returns the associated
          widget ID.  When using this function to create the Pulldown
          MenuPane, a MenuShell widget is automatically created as the
          parent of the MenuPane. If the widget specified by the
          parent parameter is a Popup or a Pulldown MenuPane, the
          MenuShell widget is created as a child of the parent's
          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 MenuPanes and is not implemented as a separate
          widget class.

          A Pulldown MenuPane displays a 3-D shadow, unless the
          feature is disabled by the application.  The shadow appears
          around the edge of the MenuPane.

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

          The Pulldown MenuPane must be attached to a CascadeButton or
          CascadeButtonGadget that resides in a MenuBar, a Popup
          MenuPane, a Pulldown MenuPane, or an OptionMenu.  This is
          done by using the button resource XmNsubMenuId.

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

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


            o  If the Pulldown MenuPane is to be pulled down from a
               MenuBar, its parent must be the MenuBar.

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

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

            o  Specifies the parent widget ID

            o  Specifies the name of the created widget

            o  Specifies the argument list

            o  Specifies the number of attribute/value pairs in the
               argument list (arglist)


          PullDown MenuPanes support tear-off capabilities for tear-
          off menus through XmRowColumn resources.  For a complete
          definition of RowColumn and its associated resources, see
          XmRowColumn(3X).

     RETURN VALUE
          Returns the RowColumn widget ID.

     RELATED INFORMATION
          XmCascadeButton(3X), XmCascadeButtonGadget(3X),
          XmCreateOptionMenu(3X), XmCreatePopupMenu(3X),
          XmCreateSimplePulldownMenu(3X), XmMenuShell(3X),
          XmRowColumn(3X), and XmVaCreateSimplePulldownMenu(3X).