manpagez: man pages & more
man XmCreatePulldownMenu(3)
Home | html | info | man
XmCreatePulldownMenu(library call)          XmCreatePulldownMenu(library call)




NAME

       XmCreatePulldownMenu  --  A RowColumn widget convenience creation func-
       tion


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 speci-
       fied 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  dis-
       abled  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 Cascade-
       ButtonGadget 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:

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

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

          o  If  the  Pulldown  menu pane is to be pulled down from an Option-
             Menu, 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)

openMotif 2.3.1 - Generated Sat Nov 29 19:03:30 CST 2008
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.