oracular (3) XmCreatePulldownMenu.3.gz

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)