1XmCreatePulldownMenu(library call)          XmCreatePulldownMenu(library call)
2
3
4

NAME

6       XmCreatePulldownMenu — A RowColumn widget convenience creation function
7

SYNOPSIS

9       #include <Xm/RowColumn.h>
10       Widget XmCreatePulldownMenu(
11       Widget parent,
12       String name,
13       ArgList arglist,
14       Cardinal argcount);
15

DESCRIPTION

17       XmCreatePulldownMenu  creates an instance of a RowColumn widget of type
18       XmMENU_PULLDOWN and returns the associated widget ID.
19
20       parent    Specifies the parent widget ID
21
22       name      Specifies the name of the created widget
23
24       arglist   Specifies the argument list
25
26       argcount  Specifies the number of attribute/value pairs in the argument
27                 list (arglist)
28
29       Specifies  the  number  of  attribute/value  pairs in the argument list
30       (arglist).  When this function is used  to  create  the  Pulldown  menu
31       pane,  a MenuShell widget is automatically created as the parent of the
32       menu pane. If the widget specified by the parent parameter is  a  Popup
33       or  a Pulldown menu pane, the MenuShell widget is created as a child of
34       the parent MenuShell; otherwise, it is created as a child of the speci‐
35       fied parent widget.
36
37       XmCreatePulldownMenu is provided as a convenience function for creating
38       RowColumn widgets configured to operate as Pulldown menu panes  and  is
39       not implemented as a separate widget class.
40
41       A  Pulldown menu pane displays a 3-D shadow, unless the feature is dis‐
42       abled by the application.  The shadow appears around the  edge  of  the
43       menu pane.
44
45       A Pulldown menu pane is used with submenus that are to be attached to a
46       CascadeButton or a CascadeButtonGadget. This is the case for  all  menu
47       panes that are part of a PulldownMenu system (a MenuBar), the menu pane
48       associated with an OptionMenu, and any menu panes that cascade  from  a
49       Popup  menu pane. Pulldown menu panes that are to be associated with an
50       OptionMenu must be created before the OptionMenu is created.
51
52       The Pulldown menu pane must be attached to a CascadeButton or  Cascade‐
53       ButtonGadget  that  resides in a MenuBar, a Popup menu pane, a Pulldown
54       menu pane, or an OptionMenu. It is attached with  the  button  resource
55       XmNsubMenuId.
56
57       A  MenuShell  widget is required between the Pulldown menu pane and its
58       parent.  If the application uses this convenience function for creating
59       a  Pulldown  menu  pane,  the MenuShell is automatically created as the
60       real parent of the  menu  pane;  otherwise,  it  is  the  application's
61       responsibility to create the MenuShell widget.
62
63       To  function correctly when incorporated into a menu, the Pulldown menu
64       pane's hierarchy must be considered. This hierarchy depends on the type
65       of menu system that is being built, as follows:
66
67          ·  If  the  Pulldown  menu pane is to be pulled down from a MenuBar,
68             its parent must be the MenuBar.
69
70          ·  If the Pulldown menu pane is to be pulled down from  a  Popup  or
71             another  Pulldown  menu  pane,  its  parent must be that Popup or
72             Pulldown menu pane.
73
74          ·  If the Pulldown menu pane is to be pulled down  from  an  Option‐
75             Menu, its parent must be the same as the OptionMenu parent.
76
77       PullDown  menu  panes  support tear-off capabilities for tear-off menus
78       through XmRowColumn resources.  For a complete definition of  RowColumn
79       and its associated resources, see XmRowColumn(3).
80

RETURN

82       Returns the RowColumn widget ID.
83
85       XmCascadeButton(3),   XmCascadeButtonGadget(3),  XmCreateOptionMenu(3),
86       XmCreatePopupMenu(3),  XmCreateSimplePulldownMenu(3),   XmMenuShell(3),
87       XmRowColumn(3), and XmVaCreateSimplePulldownMenu(3).
88
89
90
91                                            XmCreatePulldownMenu(library call)
Impressum