1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
|
'\" t
...\" CrePuA.sgm /main/8 1996/09/08 20:34:44 rws $
.de P!
.fl
\!!1 setgray
.fl
\\&.\"
.fl
\!!0 setgray
.fl \" force out current output buffer
\!!save /psv exch def currentpoint translate 0 0 moveto
\!!/showpage{}def
.fl \" prolog
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
\!!psv restore
.
.de pF
.ie \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie !\\*(f4 \{\
. ft \\*(f4
. ds f4\"
' br \}
.el .ie !\\*(f3 \{\
. ft \\*(f3
. ds f3\"
' br \}
.el .ie !\\*(f2 \{\
. ft \\*(f2
. ds f2\"
' br \}
.el .ie !\\*(f1 \{\
. ft \\*(f1
. ds f1\"
' br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
.TH "XmCreatePulldownMenu" "library call"
.SH "NAME"
\fBXmCreatePulldownMenu\fP \(em A RowColumn widget convenience creation function
.iX "XmCreatePulldownMenu"
.iX "creation functions" "XmCreatePulldownMenu"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/RowColumn\&.h>
\fBWidget \fBXmCreatePulldownMenu\fP\fR(
\fBWidget \fBparent\fR\fR,
\fBString \fBname\fR\fR,
\fBArgList \fBarglist\fR\fR,
\fBCardinal \fBargcount\fR\fR);
.fi
.SH "DESCRIPTION"
.PP
\fBXmCreatePulldownMenu\fP creates an instance of a
RowColumn widget of type \fBXmMENU_PULLDOWN\fP and returns
the associated widget ID\&.
.IP "\fIparent\fP" 10
Specifies the parent widget ID
.IP "\fIname\fP" 10
Specifies the name of the created widget
.IP "\fIarglist\fP" 10
Specifies the argument list
.IP "\fIargcount\fP" 10
Specifies the number of attribute/value pairs in the argument list
(\fIarglist\fP)
.PP
Specifies the number of attribute/value pairs in the argument list
(\fIarglist\fP)\&.
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 \fIparent\fP parameter is a
Popup or a Pulldown menu pane, the MenuShell
widget is created as a child of the \fIparent\fP MenuShell; otherwise, it
is created as a child of the specified \fIparent\fP widget\&.
.PP
\fBXmCreatePulldownMenu\fP 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\&.
.PP
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\&.
.PP
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\&.
.PP
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 \fBXmNsubMenuId\fP\&.
.PP
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\&.
.PP
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:
.IP " \(bu" 6
If the Pulldown menu pane is to be pulled down from a MenuBar, its \fIparent\fP
must be the MenuBar\&.
.IP " \(bu" 6
If the Pulldown menu pane is to be pulled down from a Popup or another
Pulldown menu pane, its \fIparent\fP must be that Popup or Pulldown menu pane\&.
.IP " \(bu" 6
If the Pulldown menu pane is to be pulled down from an OptionMenu, its
\fIparent\fP must be the same as the OptionMenu parent\&.
.PP
PullDown menu panes support tear-off capabilities
for tear-off menus through \fBXmRowColumn\fP
resources\&.
For a complete definition of RowColumn and its associated resources, see
\fBXmRowColumn\fP(3)\&.
.SH "RETURN"
.PP
Returns the RowColumn widget ID\&.
.SH "RELATED"
.PP
\fBXmCascadeButton\fP(3),
\fBXmCascadeButtonGadget\fP(3),
\fBXmCreateOptionMenu\fP(3),
\fBXmCreatePopupMenu\fP(3),
\fBXmCreateSimplePulldownMenu\fP(3),
\fBXmMenuShell\fP(3),
\fBXmRowColumn\fP(3), and
\fBXmVaCreateSimplePulldownMenu\fP(3)\&.
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:20
|
