XmCreatePulldownMenu(library call)       XmCreatePulldownMenu(library call)




 NAME    [Toc]    [Back]
      XmCreatePulldownMenu - A RowColumn widget convenience creation
      function

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

 DESCRIPTION    [Toc]    [Back]
      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



                                    - 1 -       Formatted:  January 24, 2005






 XmCreatePulldownMenu(library call)       XmCreatePulldownMenu(library call)




      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:

         +  If the Pulldown menu pane is to be pulled down from a MenuBar,
            its parent must be the MenuBar.

         +  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.

         +  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 XmRowColumn resources.  For a complete definition of RowColumn
      and its associated resources, see XmRowColumn(3).

 RETURN    [Toc]    [Back]
      Returns the RowColumn widget ID.

 RELATED    [Toc]    [Back]
      XmCascadeButton(3), XmCascadeButtonGadget(3), XmCreateOptionMenu(3),
      XmCreatePopupMenu(3), XmCreateSimplePulldownMenu(3), XmMenuShell(3),
      XmRowColumn(3), and XmVaCreateSimplePulldownMenu(3).


                                    - 2 -       Formatted:  January 24, 2005