NAME

       XmCreatePulldownMenu    —    A    RowColumn    widget    convenience   creation   function
       "XmCreatePulldownMenu" "creation functions" "XmCreatePulldownMenu"

SYNOPSIS

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

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:

          •  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

       Returns the RowColumn widget ID.

RELATED

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

                                                                          XmCreatePulldownMenu(3)