Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmVaCreateSimpleCheckBox(3) Library Functions Manual XmVaCreateSimpleCheckBox(3)

NAME
     XmVaCreateSimpleCheckBox  --  A RowColumn widget convenience creation func-
     tion

SYNOPSIS
     #include <Xm/RowColumn.h>
     Widget XmVaCreateSimpleCheckBox(
     Widget parent,
     String name,
     XtCallbackProc callback);

DESCRIPTION
     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 in-
     teger from 0 (zero) to the number of buttons in the menu minus 1.	 Buttons
     are named and created in the order in which they are specified in the vari-
     able portion of the argument list.

     parent    Specifies the parent widget ID.

     name      Specifies the name of the created widget.

     callback  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.  The following list describes the possible first arguments in each
     group of varargs:

     XmVaCHECKBUTTON
	       This  is followed by four additional arguments. The set specifies
	       one button in the CheckBox and some of its resource values.   The
	       following list describes the additional four arguments, in order.

	       label	 The label string, of type XmString

	       mnemonic  The  mnemonic,  of type KeySym. This is ignored in this
			 release.

	       accelerator
			 The accelerator, of type String.  This  is  ignored  in
			 this release.

	       accelerator_text
			 The accelerator text, of type XmString. This is ignored
			 in this release.

     resource_name
	       This is followed by one additional argument, the value of the re-
	       source,	of  type XtArgVal. The pair specifies a resource and its
	       value for the RowColumn widget.

     XtVaTypedArg
	       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  ad-
	       ditional four arguments, in order:

	       name	 The resource name, of type String

	       type	 The type of the resource value supplied, of type String

	       value	 The resource value (or a pointer to the resource value,
			 depending  on	the type and size of the value), of type
			 XtArgVal

	       size	 The size of the resource value in bytes, of type int

     XtVaNestedList
	       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 as-
     sociated resources, see XmRowColumn(3).

RETURN
     Returns the RowColumn widget ID.

RELATED
     XmCreateRadioBox(3), XmCreateRowColumn(3),  XmCreateSimpleCheckBox(3),  Xm-
     CreateSimpleRadioBox(3), XmRowColumn(3), and XmVaCreateSimpleRadioBox(3).

						     XmVaCreateSimpleCheckBox(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmVaCreateSimpleCheckBox&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help