Класс 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 не реализуют состояние выбора.

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

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

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в одной из будущих версий. Финализация объявлена устаревшей и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает текущий поток до тех пор, пока он не будет разбужен, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до тех пор, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет заданный промежуток реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до тех пор, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет заданный промежуток реального времени.

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

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.