1XmVaCreateSimpleMenuBar(library call) XmVaCreateSimpleMenuBar(library call)
2
3
4
6 XmVaCreateSimpleMenuBar — A RowColumn widget convenience creation func‐
7 tion
8
10 #include <Xm/RowColumn.h>
11 Widget XmVaCreateSimpleMenuBar(
12 Widget parent,
13 String name);
14
16 XmVaCreateSimpleMenuBar creates an instance of a RowColumn widget of
17 type XmMENU_BAR and returns the associated widget ID. This routine
18 uses the ANSI C variable-length argument list (varargs) calling conven‐
19 tion.
20
21 This routine creates a MenuBar and its CascadeButtonGadget children.
22 The name of each button is button_n, where n is an integer from 0
23 (zero) to the number of buttons in the menu minus 1. Buttons are named
24 and created in the order in which they are specified in the variable
25 portion of the argument list.
26
27 parent Specifies the parent widget ID
28
29 name Specifies the name of the created widget
30
31 The variable portion of the argument list consists of groups of argu‐
32 ments. The first argument in each group is a constant or a string and
33 determines which arguments follow in that group. The last argument in
34 the list must be NULL. Following are the possible first arguments in
35 each group of varargs:
36
37 XmVaCASCADEBUTTON
38 This is followed by two additional arguments. The set speci‐
39 fies one button in the MenuBar and some of its resource val‐
40 ues. Following are the additional two arguments, in order:
41
42 label The label string, of type XmString
43
44 mnemonic The mnemonic, of type KeySym
45
46 resource_name
47 This is followed by one additional argument, the value of the
48 resource, of type XtArgVal. The pair specifies a resource and
49 its value for the RowColumn widget.
50
51 XtVaTypedArg
52 This is followed by four additional arguments. The set speci‐
53 fies a resource and its value for the RowColumn widget. A
54 resource type conversion is performed if necessary. Following
55 are the additional four arguments, in order:
56
57 name The resource name, of type String
58
59 type The type of the resource value supplied, of type
60 String
61
62 value The resource value (or a pointer to the resource
63 value, depending on the type and size of the
64 value), of type XtArgVal
65
66 size The size of the resource value in bytes, of type
67 int
68
69 XtVaNestedList
70 This is followed by one additional argument of type
71 XtVarArgsList. This argument is a nested list of varargs
72 returned by XtVaCreateArgsList.
73
74 For more information on variable-length argument lists, see the X Tool‐
75 kit Intrinsics documentation.
76
77 A number of resources exist specifically for use with this and other
78 simple menu creation routines. For a complete definition of RowColumn
79 and its associated resources, see XmRowColumn(3).
80
82 Returns the RowColumn widget ID.
83
85 XmCreateMenuBar(3), XmCreateRowColumn(3), XmCreateSimpleMenuBar(3), and
86 XmRowColumn(3).
87
88
89
90 XmVaCreateSimpleMenuBar(library call)