Класс 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 Tutorial.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими с той же версией Swing. С версии 1.4 добавлена поддержка долгосрочного хранения всех JavaBeans в пакете java.beans. См. 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`.

Методы, унаследованные от класса java.lang.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()

Возвращает все кнопки, участвующие в этой группе.

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

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, 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