[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Programmer's Reference


XmCreateSimpleCheckBox

A RowColumn widget convenience creation function

Format

#include <Xm/RowColumn.h>
Widget XmCreateSimpleCheckBox
Widget
parentString nameArgList
arglistCardinal argcount

DESCRIPTION

XmCreateSimpleCheckBox creates an instance of a RowColumn widget of type XmWORK_AREA and returns the associated widget ID.

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 (zero) to the number of buttons in the menu minus 1. Buttons are named and created in the order they are specified in the RowColumn simple menu creation resources supplied in the argument list.

parent
Specifies the parent widget ID

name
Specifies the name of the created widget

arglist
Specifies the argument list

argcount
Specifies the number of attribute/value pairs in the argument list ( arglist)

A number of resources exist specifically for use with this and other simple menu creation routines. The only button type allowed in the XmNbuttonType resource is XmCHECKBUTTON. For a complete definition of RowColumn and its associated resources, see XmRowColumn (3).

RETURN

Returns the RowColumn widget ID.

RELATED

XmCreateRadioBox (3), XmCreateRowColumn (3), XmCreateSimpleRadioBox (3), XmRowColumn (3), XmVaCreateSimpleCheckBox (3), and XmVaCreateSimpleRadioBox (3).


[ Previous | Next | Contents | Glossary | Home | Search ]