Класс 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, 2021, 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/17/docs/api/java.desktop/javax/swing/ButtonGroup.html