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

NAME

6       XmVaCreateSimpleCheckBox  —  A  RowColumn  widget  convenience creation
7       function
8

SYNOPSIS

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

DESCRIPTION

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

RETURN

101       Returns the RowColumn widget ID.
102
104       XmCreateRadioBox(3),  XmCreateRowColumn(3),  XmCreateSimpleCheckBox(3),
105       XmCreateSimpleRadioBox(3),  XmRowColumn(3),   and   XmVaCreateSimpleRa‐
106       dioBox(3).
107
108
109
110                                        XmVaCreateSimpleCheckBox(library call)
Impressum