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

NAME

6       XmVaCreateSimpleRadioBox  —  A  RowColumn  widget  convenience creation
7       function
8

SYNOPSIS

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

DESCRIPTION

18       XmVaCreateSimpleRadioBox creates an instance of a RowColumn  widget  of
19       type  XmWORK_AREA  and  returns the associated widget ID.  This routine
20       uses the ANSI C variable-length argument list (varargs) calling conven‐
21       tion.
22
23       This  routine  creates  a RadioBox and its ToggleButtonGadget children.
24       The name of each button is button_n, where  n  is  an  integer  from  0
25       (zero) to the number of buttons in the menu minus 1.
26
27       parent    Specifies the parent widget ID.
28
29       name      Specifies the name of the created widget.
30
31       button_set
32                 Specifies  which  button  is initially set.  The value is the
33                 integer n in the button name button_n.
34
35       callback  Specifies a callback procedure to be called when  a  button's
36                 value  changes.  This callback function is added to each but‐
37                 ton after creation as the  button's  XmNvalueChangedCallback.
38                 The  callback  function  is  called  when  a  button's  value
39                 changes, and the button number is returned in the client_data
40                 field.
41
42       The  variable  portion of the argument list consists of groups of argu‐
43       ments.  The first argument in each group is a constant or a string  and
44       determines  which arguments follow in that group.  The last argument in
45       the list must be NULL.  Following are the possible first  arguments  in
46       each group of varargs:
47
48       XmVaRADIOBUTTON
49                 This is followed by four additional arguments. The set speci‐
50                 fies one button in the RadioBox and some of its resource val‐
51                 ues. Following are the additional four arguments, in order:
52
53                 label     The label string, of type XmString.
54
55                 mnemonic  The  mnemonic,  of  type KeySym. This is ignored in
56                           this release.
57
58                 accelerator
59                           The accelerator, of type String. This is ignored in
60                           this release.
61
62                 accelerator_text
63                           The  accelerator  text,  of  type XmString. This is
64                           ignored in this release.
65
66       resource_name
67                 This is followed by one additional argument, the value of the
68                 resource, of type XtArgVal. The pair specifies a resource and
69                 its value for the RowColumn widget.
70
71       XtVaTypedArg
72                 This is followed by four additional arguments. The set speci‐
73                 fies  a  resource  and  its value for the RowColumn widget. A
74                 resource type conversion is performed if necessary. Following
75                 are the additional four arguments, in this order:
76
77                 name      The resource name, of type String
78
79                 type      The  type  of  the resource value supplied, of type
80                           String
81
82                 value     The resource value (or a pointer  to  the  resource
83                           value,  depending  on  the  type  and  size  of the
84                           value), of type XtArgVal
85
86                 size      The size of the resource value in  bytes,  of  type
87                           int
88
89       XtVaNestedList
90                 This   is   followed  by  one  additional  argument  of  type
91                 XtVarArgsList. This argument is  a  nested  list  of  varargs
92                 returned by XtVaCreateArgsList.
93
94       For more information on variable-length argument lists, see the X Tool‐
95       kit Intrinsics documentation.
96
97       A number of resources exist specifically for use with  this  and  other
98       simple  menu creation routines.  For a complete definition of RowColumn
99       and its associated resources, see XmRowColumn(3).
100

RETURN

102       Returns the RowColumn widget ID.
103
105       XmCreateRadioBox(3),  XmCreateRowColumn(3),  XmCreateSimpleCheckBox(3),
106       XmCreateSimpleRadioBox(3),  XmRowColumn(3),  and XmVaCreateSimpleCheck‐
107       Box(3),
108
109
110
111                                        XmVaCreateSimpleRadioBox(library call)
Impressum