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

NAME

6       XmVaCreateSimplePopupMenu  —  A  RowColumn  widget convenience creation
7       function
8

SYNOPSIS

10       #include <Xm/RowColumn.h>
11       Widget XmVaCreateSimplePopupMenu(
12       Widget parent,
13       String name,
14       XtCallbackProc callback);
15

DESCRIPTION

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
22       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
32       parent    Specifies the widget ID of the parent of the MenuShell
33
34       name      Specifies the name of the created widget
35
36       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
46       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
52       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
58                 label     The label string, of type XmString
59
60                 mnemonic  The mnemonic, of type KeySym
61
62       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
68                 label     The label string, of type XmString
69
70                 mnemonic  The mnemonic, of type KeySym
71
72                 accelerator
73                           The accelerator, of type String
74
75                 accelerator_text
76                           The accelerator text, of type XmString
77
78       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
84                 label     The label string, of type XmString
85
86                 mnemonic  The mnemonic, of type KeySym
87
88                 accelerator
89                           The accelerator, of type String
90
91                 accelerator_text
92                           The accelerator text, of type XmString
93
94       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
100                 label     The label string, of type XmString
101
102                 mnemonic  The mnemonic, of type KeySym
103
104                 accelerator
105                           The accelerator, of type String
106
107                 accelerator_text
108                           The accelerator text, of type XmString
109
110       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
114                 title     The title string, of type XmString
115
116       XmVaSEPARATOR
117                 This is followed by no additional arguments. It specifies one
118                 separator in the PopupMenu.
119
120       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
125       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
130       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
136                 name      The resource name, of type String
137
138                 type      The  type  of  the resource value supplied, of type
139                           String
140
141                 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
145                 size      The size of the resource value in  bytes,  of  type
146                           int
147
148       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
153       For more information on variable-length argument lists, see the X Tool‐
154       kit Intrinsics documentation.
155
156       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

RETURN

161       Returns the RowColumn widget ID.
162
164       XmCreatePopupMenu(3), XmCreateRowColumn(3), XmCreateSimplePopupMenu(3),
165       and XmRowColumn(3).
166
167
168
169                                       XmVaCreateSimplePopupMenu(library call)
Impressum