1XmCreatePulldownMenu(library call) XmCreatePulldownMenu(library call)
2
3
4
6 XmCreatePulldownMenu — A RowColumn widget convenience creation function
7
9 #include <Xm/RowColumn.h>
10 Widget XmCreatePulldownMenu(
11 Widget parent,
12 String name,
13 ArgList arglist,
14 Cardinal argcount);
15
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
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)