java.lang.Object
java.awt.CheckboxGroup
- All Implemented Interfaces:
Serializable
The
CheckboxGroup
class is used to group together
a set of Checkbox
buttons.
Exactly one check box button in a CheckboxGroup
can
be in the "on" state at any given time. Pushing any
button sets its state to "on" and forces any other button that
is in the "on" state into the "off" state.
The following code example produces a new check box group, with three check boxes:
setLayout(new GridLayout(3, 1)); CheckboxGroup cbg = new CheckboxGroup(); add(new Checkbox("one", cbg, true)); add(new Checkbox("two", cbg, false)); add(new Checkbox("three", cbg, false));
This image depicts the check box group created by this example:
- Since:
- 1.0
- See Also:
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionDeprecated.Gets the current choice from this check box group.void
setCurrent
(Checkbox box) Deprecated.As of JDK version 1.1, replaced bysetSelectedCheckbox(Checkbox)
.void
Sets the currently selected check box in this group to be the specified check box.toString()
Returns a string representation of this check box group, including the value of its current selection.
-
Constructor Details
-
CheckboxGroup
public CheckboxGroup()Creates a new instance ofCheckboxGroup
.
-
-
Method Details
-
getSelectedCheckbox
Gets the current choice from this check box group. The current choice is the check box in this group that is currently in the "on" state, ornull
if all check boxes in the group are off.- Returns:
- the check box that is currently in the
"on" state, or
null
. - Since:
- 1.1
- See Also:
-
getCurrent
Deprecated.As of JDK version 1.1, replaced bygetSelectedCheckbox()
.Returns the current choice from this check box group ornull
if none of checkboxes are selected.- Returns:
- the selected checkbox
-
setSelectedCheckbox
Sets the currently selected check box in this group to be the specified check box. This method sets the state of that check box to "on" and sets all other check boxes in the group to be off.If the check box argument is
null
, all check boxes in this check box group are deselected. If the check box argument belongs to a different check box group, this method does nothing.- Parameters:
box
- theCheckbox
to set as the current selection.- Since:
- 1.1
- See Also:
-
setCurrent
Deprecated.As of JDK version 1.1, replaced bysetSelectedCheckbox(Checkbox)
.Sets the currently selected check box in this group to be the specified check box and unsets all others.- Parameters:
box
- theCheckbox
to set as the current selection.
-
toString
-
getSelectedCheckbox()
.