NAME    [Toc]    [Back]

       XmVaCreateSimpleCheckBox  - A RowColumn widget convenience
       creation function

SYNOPSIS    [Toc]    [Back]

       #include <Xm/RowColumn.h>

       Widget XmVaCreateSimpleCheckBox (parent,  name,  callback,
       arg...)
               Widget parent;
               String name;
               XtCallbackProc callback;

DESCRIPTION    [Toc]    [Back]

       XmVaCreateSimpleCheckBox  creates an instance of a RowColumn
 widget of type XmWORK_AREA and returns the  associated
       widget  ID.  This  routine uses the ANSI C variable-length
       argument list (varargs) calling convention.

       This routine creates a CheckBox and its ToggleButtonGadget
       children.   A  CheckBox  is  similar to a RadioBox, except
       that more than one button can be selected at a  time.  The
       name  of  each  button  is button_n, where n is an integer
       from 0 to one minus the number of  buttons  in  the  menu.
       Buttons  are  named and created in the order in which they
       are specified in the  variable  portion  of  the  argument
       list.  Specifies the parent widget ID.  Specifies the name
       of the created widget.  Specifies a callback procedure  to
       be  called  when  a  button's value changes. This callback
       function is added to each button  after  creation  as  the
       button's  XmNvalueChangedCallback.   The callback function
       is called when a button's value changes,  and  the  button
       number is returned in the client_data field.

       The  variable  portion  of  the  argument list consists of
       groups of arguments.  The first argument in each group  is
       a constant or a string and determines which arguments follow
 in that group. The last argument in the list  must  be
       NULL.  Following  are the possible first arguments in each
       group of varargs: This  is  followed  by  four  additional
       arguments.   The  set specifies one button in the CheckBox
       and some of its resource values.  Following are the  additional
 four arguments, in this order: The label string, of
       type XmString.  The mnemonic, of  type  KeySym.   This  is
       ignored in this release.  The accelerator, of type String.
       This is ignored in this release.  The accelerator text, of
       type  XmString.  This is ignored in this release.  This is
       followed by one additional  argument,  the  value  of  the
       resource, of type XtArgVal.  The pair specifies a resource
       and its value for the RowColumn widget.  This is  followed
       by   four  additional  arguments.   The  set  specifies  a
       resource and  its  value  for  the  RowColumn  widget.   A
       resource  type conversion is performed if necessary.  Following
 are the additional four arguments, in  this  order:
       The  resource  name,  of  type  String.   The  type of the
       resource value supplied, of  type  String.   The  resource
       value  (or  a  pointer to the resource value, depending on
       the type and size of the value), of  type  XtArgVal.   The
       size of the resource value in bytes, of type int.  This is
       followed by one additional argument of type XtVarArgsList.
       This  argument  is  a  nested  list of varargs returned by
       XtVaCreateArgsList.

       For more information on  variable-length  argument  lists,
       see the X Toolkit Intrinsics documentation.

       A number of resources exist specifically for use with this
       and other simple menu creation routines.  For  a  complete
       definition  of RowColumn and its associated resources, see
       XmRowColumn(3X).

RETURN VALUE    [Toc]    [Back]

       Returns the RowColumn widget ID.

SEE ALSO    [Toc]    [Back]

       XmCreateRadioBox(3X), XmCreateRowColumn(3X),  XmCreateSimpleCheckBox(3X),   XmCreateSimpleRadioBox(3X),   XmRowColumn(3X), XmVaCreateSimpleRadioBox(3X)



                                     XmVaCreateSimpleCheckBox(3X)