Serializable
public class ButtonGroup extends Object implements 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
.
Modifier and Type | Field | Description |
---|---|---|
protected Vector |
buttons |
The list of buttons participating in this group. |
Constructor | Description |
---|---|
ButtonGroup() |
Creates a new ButtonGroup . |
Modifier and Type | Method | Description |
---|---|---|
void |
add |
Adds the button to the group. |
void |
clearSelection() |
Clears the selection such that none of the buttons in the ButtonGroup are selected. |
int |
getButtonCount() |
Returns the number of buttons in the group. |
Enumeration |
getElements() |
Returns all the buttons that are participating in this group. |
ButtonModel |
getSelection() |
Returns the model of the selected button. |
boolean |
isSelected |
Returns whether a ButtonModel is selected. |
void |
remove |
Removes the button from the group. |
void |
setSelected |
Sets the selected value for the ButtonModel . |
protected Vector<AbstractButton> buttons
public ButtonGroup()
ButtonGroup
.public void add(AbstractButton b)
b
- the button to be addedpublic void remove(AbstractButton b)
b
- the button to be removedpublic void clearSelection()
ButtonGroup
are selected.public Enumeration<AbstractButton> getElements()
Enumeration
of the buttons in this grouppublic ButtonModel getSelection()
public void setSelected(ButtonModel m, boolean b)
ButtonModel
. Only one button in the group may be selected at a time.m
- the ButtonModel
b
- true
if this button is to be selected, otherwise false
public boolean isSelected(ButtonModel m)
ButtonModel
is selected.m
- an instance of ButtonModel
true
if the button is selected, otherwise returns false
public int getButtonCount()
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/ButtonGroup.html