Checkbox
Usage | Design-relevant Attributes | Related Controls
 |
Checkboxes offer one or multiple choices to the user. The user can select none, one, or as many options as desired in a group of checkboxes. |
| Figure 1: A checkbox group | |
Usage
Checkboxes are the appropriate elements when users can choose between multiple options. They can appear as a single checkbox or grouped.
In a checkbox group the choices are not exclusive, that is, a user can check several options in a group. If you need single-selection use radio buttons or a dropdown list box, instead.
Checkbox Group
For groups of checkboxes use the checkbox group control if applicable. This control allows to arrange checkboxes in one column, one row, or in a matrix-like fashion.
Note: It is not possible to determine the horizontal spacing within a checkbox group. If you need a different spacing than that supplied by the checkbox group control, use single checkboxes and a grid layout control if applicable.
Arrangement and Design Alternatives
For details on the arrangement of checkboxes as well as for design alternatives see Forms - Using Checkboxes.
Design-relevant Attributes
Checkboxes have the disabled and checked attributes. Set disabled to TRUE if a checkbox cannot be checked or unchecked by a user temporarily. Set checked to TRUE to preset a checkbox to the checked state. Use attribute text to set the descriptive label text for a checkbox.
You can also set the column count for checkbox groups (attribute columnCount).