1XmVaCreateSimplePopupMenu(library call)XmVaCreateSimplePopupMenu(library call)
2
6 XmVaCreateSimplePopupMenu — A RowColumn widget convenience creation
7 function
8
10 #include <Xm/RowColumn.h>
11 Widget XmVaCreateSimplePopupMenu(
12 Widget parent,
13 String name,
14 XtCallbackProc callback);
15
17 XmVaCreateSimplePopupMenu creates an instance of a RowColumn widget of
18 type XmMENU_POPUP and returns the associated widget ID. This routine
19 uses the ANSI C variable-length argument list (varargs) calling conven‐
20 tion.
21 This routine creates a Popup menu pane and its button children. The
23 name of each button is button_n, where n is an integer from 0 (zero) to
24 the number of buttons in the menu minus 1. The name of each separator
25 is separator_n, where n is an integer from 0 (zero) to the number of
26 separators in the menu minus 1. The name of each title is label_n,
27 where n is an integer from 0 (zero) to the number of titles in the menu
28 minus 1. Buttons, separators, and titles are named and created in the
29 order in which they are specified in the variable portion of the argu‐
30 ment list.
31 parent Specifies the widget ID of the parent of the MenuShell
33 name Specifies the name of the created widget
35 callback Specifies a callback procedure to be called when a button is
37 activated or when its value changes. This callback function
38 is added to each button after creation. For a CascadeButton‐
39 Gadget or a PushButtonGadget, the callback is added as the
40 button's XmNactivateCallback, and it is called when the but‐
41 ton is activated. For a ToggleButtonGadget, the callback is
42 added as the button's XmNvalueChangedCallback, and it is
43 called when the button's value changes. The button number is
44 returned in the client_data field.
45 The variable portion of the argument list consists of groups of argu‐
47 ments. The first argument in each group is a constant or a string and
48 determines which arguments follow in that group. The last argument in
49 the list must be NULL. The following list describes the possible first
50 arguments in each group of varargs.
51 XmVaCASCADEBUTTON
53 This is followed by two additional arguments. The set speci‐
54 fies one button in the PopupMenu and some of its resource
55 values. The button created is a CascadeButtonGadget. Follow‐
56 ing are the additional two arguments, in order:
57 label The label string, of type XmString
59 mnemonic The mnemonic, of type KeySym
61 XmVaPUSHBUTTON
63 This is followed by four additional arguments. The set speci‐
64 fies one button in the PopupMenu and some of its resource
65 values. The button created is a PushButtonGadget. Following
66 are the additional four arguments, in order:
67 label The label string, of type XmString
69 mnemonic The mnemonic, of type KeySym
71 accelerator
73 The accelerator, of type String
74 accelerator_text
76 The accelerator text, of type XmString
77 XmVaRADIOBUTTON
79 This is followed by four additional arguments. The set speci‐
80 fies one button in the PopupMenu and some of its resource
81 values. The button created is a ToggleButtonGadget. Following
82 are the additional four arguments, in order:
83 label The label string, of type XmString
85 mnemonic The mnemonic, of type KeySym
87 accelerator
89 The accelerator, of type String
90 accelerator_text
92 The accelerator text, of type XmString
93 XmVaCHECKBUTTON
95 This is followed by four additional arguments. The set speci‐
96 fies one button in the PopupMenu and some of its resource
97 values. The button created is a ToggleButtonGadget. Following
98 are the additional four arguments, in order:
99 label The label string, of type XmString
101 mnemonic The mnemonic, of type KeySym
103 accelerator
105 The accelerator, of type String
106 accelerator_text
108 The accelerator text, of type XmString
109 XmVaTITLE This is followed by one additional argument. The pair speci‐
111 fies a title LabelGadget in the PopupMenu. Following is the
112 additional argument:
113 title The title string, of type XmString
115 XmVaSEPARATOR
117 This is followed by no additional arguments. It specifies one
118 separator in the PopupMenu.
119 XmVaDOUBLE_SEPARATOR
121 This is followed by no additional arguments. It specifies one
122 separator in the PopupMenu. The separator type is XmDOU‐
123 BLE_LINE.
124 resource_name
126 This is followed by one additional argument, the value of the
127 resource, of type XtArgVal. The pair specifies a resource and
128 its value for the RowColumn widget.
129 XtVaTypedArg
131 This is followed by four additional arguments. The set speci‐
132 fies a resource and its value for the RowColumn widget. A
133 resource type conversion is performed if necessary. Following
134 are the additional four arguments, in order:
135 name The resource name, of type String
137 type The type of the resource value supplied, of type
139 String
140 value The resource value (or a pointer to the resource
142 value, depending on the type and size of the
143 value), of type XtArgVal
144 size The size of the resource value in bytes, of type
146 int
147 XtVaNestedList
149 This is followed by one additional argument of type
150 XtVarArgsList. This argument is a nested list of varargs
151 returned by XtVaCreateArgsList.
152 For more information on variable-length argument lists, see the X Tool‐
154 kit Intrinsics documentation.
155 A number of resources exist specifically for use with this and other
157 simple menu creation routines. For a complete definition of RowColumn
158 and its associated resources, see XmRowColumn(3).
159
161 Returns the RowColumn widget ID.
162
164 XmCreatePopupMenu(3), XmCreateRowColumn(3), XmCreateSimplePopupMenu(3),
165 and XmRowColumn(3).
166 XmVaCreateSimplePopupMenu(library call)