- All Implemented Interfaces:
Serializable
ButtonGroup
object means that
turning "on" one of those buttons
turns off all other buttons in the group.
A ButtonGroup
can be used with
any set of objects that inherit from AbstractButton
.
Typically a button group contains instances of
JRadioButton
,
JRadioButtonMenuItem
,
or JToggleButton
.
It wouldn't make sense to put an instance of
JButton
or JMenuItem
in a button group
because JButton
and JMenuItem
don't implement the selected state.
Initially, all buttons in the group are unselected.
For examples and further information on using button groups see How to Use Radio Buttons, a section in The Java Tutorial.
Warning:
Serialized objects of this class will not be compatible with
future Swing releases. The current serialization support is
appropriate for short term storage or RMI between applications running
the same version of Swing. As of 1.4, support for long term storage
of all JavaBeans
has been added to the java.beans
package.
Please see XMLEncoder
.
- Since:
- 1.2
-
Field Summary
Modifier and TypeFieldDescriptionprotected Vector
<AbstractButton> The list of buttons participating in this group. -
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
Adds the button to the group.void
Clears the selection such that none of the buttons in theButtonGroup
are selected.int
Returns the number of buttons in the group.Returns all the buttons that are participating in this group.Returns the model of the selected button.boolean
Returns whether aButtonModel
is selected.void
Removes the button from the group.void
setSelected
(ButtonModel m, boolean b) Sets the selected value for theButtonModel
.
-
Field Details
-
buttons
The list of buttons participating in this group.
-
-
Constructor Details
-
ButtonGroup
public ButtonGroup()Creates a newButtonGroup
.
-
-
Method Details
-
add
Adds the button to the group.- Parameters:
b
- the button to be added
-
remove
Removes the button from the group.- Parameters:
b
- the button to be removed
-
clearSelection
public void clearSelection()Clears the selection such that none of the buttons in theButtonGroup
are selected.- Since:
- 1.6
-
getElements
Returns all the buttons that are participating in this group.- Returns:
- an
Enumeration
of the buttons in this group
-
getSelection
Returns the model of the selected button.- Returns:
- the selected button model
-
setSelected
Sets the selected value for theButtonModel
. Only one button in the group may be selected at a time.- Parameters:
m
- theButtonModel
b
-true
if this button is to be selected, otherwisefalse
-
isSelected
Returns whether aButtonModel
is selected.- Parameters:
m
- an instance ofButtonModel
- Returns:
true
if the button is selected, otherwise returnsfalse
-
getButtonCount
public int getButtonCount()Returns the number of buttons in the group.- Returns:
- the button count
- Since:
- 1.3
-