XmCreatePulldownMenu

XmCreatePulldownMenu(library call)          XmCreatePulldownMenu(library call)



NAME
       XmCreatePulldownMenu — A RowColumn widget convenience creation function

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(library call)