- or other context-dependent keys""") -``` - -
" + - "or other context-dependent keys"); -``` - -
+ JCheckBox,
+ JBCheckBox
+
+ Use checkboxes for yes/no choices or for selecting several items in a group:
+
+ Use radio button instead if:
+
+ 
+ |
+ Only one option in a group can be selected | +
+ 
+ |
+ The behavior in the "off" state is unclear from the checkbox label. Use two radio buttons instead + and label them accordingly + | +
+ 
+ |
+ With the checkbox, it is unclear how the setting works if it’s unchecked. With radio buttons, both + states are labeled clearly + | +
 |
+ A label accompanies each checkbox and is placed next to it. | +
 |
+ If a label is long, split it into two lines. Use HTML formatting for that. | +
Avoid labels that take more than two lines. See recommendations on writing concise labels below.
+If a checkbox appears in a table, place the label into the column header and do not repeat it on every + row.
+
+
+ BooleanTableCellRenderer
+ and edited with DefaultCellEditor(JCheckBox) implementation.
+ For any column that should be rendered as a checkbox, set both a renderer and editor for consistency.
+ The type of data in the correspondent column of the Table model should either be Boolean
+ or String containing true or false.
+
Use sentence-style capitalization.
+Do not use ending punctuation.
+Use the imperative form of verbs
+|
+
+ |
+
+
+ |
+
 |
+  |
+
Do not use negation in labels as it complicates understanding.
+|
+
+ |
+
+
+ |
+
 |
+  |
+
Make labels short and intelligible — see Writing short and clear.
+In a group of options, use the parent checkbox to show the status of its children.
+
+
+ ThreeStateCheckBox
+ class which represents its state with the ThreeStateCheckBox.State enum containing SELECTED,
+ NOT_SELECTED, DONT_CARE states.
+
When the user clicks an indeterminate checkbox for the first time, the whole group becomes checked. The + second click unchecks the whole group.
+An indeterminate checkbox can also show the download status. An example with a remote repository:
+
+
+
+ ThreeStateCheckBoxRenderer
+ that provides both TableCellRenderer and TableEditor.
+ It accepts Boolean type in the column being supplied by the TableModel and
+ becomes DONT_CARE when the value in the cell is null.
+ Otherwise, it becomes SELECTED for Boolean.TRUE, and NOT_SELECTED
+ for Boolean.FALSE.
+
If a checkbox depends on another control, e.g., an input field, follow the rules for dependent + controls. Otherwise, follow the rules for independent + controls.
+