Класс ButtonGroup

java.lang.Object

javax.swing.ButtonGroup

Все реализуемые интерфейсы:: Serializable

public class ButtonGroup extends Object implements Serializable

Этот класс используется для создания области взаимоисключения для набора кнопок. Создание набора кнопок с одним и тем же объектом ButtonGroup означает, что включение одной из этих кнопок выключает все остальные кнопки в группе.

ButtonGroup можно использовать с любым набором объектов, наследующих AbstractButton. Обычно группа кнопок содержит экземпляры JRadioButton, JRadioButtonMenuItem или JToggleButton. Помещать экземпляр JButton или JMenuItem в группу кнопок не имеет смысла, поскольку JButton и JMenuItem не реализуют состояние выбора.

Изначально ни одна кнопка в группе не выбрана.

Примеры и дополнительную информацию об использовании групп кнопок см. в разделе Как использовать переключатели учебника Учебник по Java.

Предупреждение: Сериализованные объекты этого класса будут несовместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4 в пакете java.beans появилась поддержка долгосрочного хранения всех JavaBeans. См. XMLEncoder.

Начиная с версии:: 1.2

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected Vector<AbstractButton>`	`buttons`	Список кнопок, входящих в эту группу.

Краткое описание конструкторов

Конструктор	Описание
`ButtonGroup()`	Создает новый `ButtonGroup`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`add(AbstractButton b)`	Добавляет кнопку в группу.
`void`	`clearSelection()`	Сбрасывает выбор, чтобы ни одна кнопка в `ButtonGroup` не была выбрана.
`int`	`getButtonCount()`	Возвращает количество кнопок в группе.
`Enumeration<AbstractButton>`	`getElements()`	Возвращает все кнопки, входящие в эту группу.
`ButtonModel`	`getSelection()`	Возвращает модель выбранной кнопки.
`boolean`	`isSelected(ButtonModel m)`	Возвращает, выбрана ли `ButtonModel`.
`void`	`remove(AbstractButton b)`	Удаляет кнопку из группы.
`void`	`setSelected(ButtonModel m, boolean b)`	Задает выбранное значение для `ButtonModel`.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

buttons

protected Vector<AbstractButton> buttons

Список кнопок, входящих в эту группу.

Подробное описание конструкторов

ButtonGroup

public ButtonGroup()

Создает новый ButtonGroup.

Подробное описание методов

add

public void add(AbstractButton b)

Добавляет кнопку в группу.

Параметры:: b — кнопка, которую нужно добавить

remove

public void remove(AbstractButton b)

Удаляет кнопку из группы.

Параметры:: b — кнопка, которую нужно удалить

clearSelection

public void clearSelection()

Сбрасывает выбор, чтобы ни одна кнопка в ButtonGroup не была выбрана.

Начиная с версии:: 1.6

getElements

public Enumeration<AbstractButton> getElements()

Возвращает все кнопки, входящие в эту группу.

Возвращает:: Enumeration кнопок в этой группе

getSelection

public ButtonModel getSelection()

Возвращает модель выбранной кнопки.

Возвращает:: модель выбранной кнопки

setSelected

public void setSelected(ButtonModel m, boolean b)

Задает выбранное значение для ButtonModel. Одновременно может быть выбрана только одна кнопка в группе.

Параметры:: m — ButtonModel; b — true, если эту кнопку нужно выбрать, иначе false

isSelected

public boolean isSelected(ButtonModel m)

Возвращает, выбрана ли ButtonModel.

Параметры:: m — экземпляр ButtonModel
Возвращает:: true, если кнопка выбрана, иначе возвращает false

getButtonCount

public int getButtonCount()

Возвращает количество кнопок в группе.

Возвращает:: количество кнопок
Начиная с версии:: 1.3

© 1993, 2025, 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/25/docs/api/java.desktop/javax/swing/ButtonGroup.html