Класс DefaultButtonModel

java.lang.Object

javax.swing.DefaultButtonModel

Все реализованные интерфейсы:: ItemSelectable, Serializable, ButtonModel

Непосредственные известные подклассы:: JToggleButton.ToggleButtonModel

public class DefaultButtonModel extends Object implements ButtonModel, Serializable

Реализация по умолчанию для модели данных компонента Button.

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

С:: 1.2

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

Модификатор и тип	Поле	Описание
`protected String`	`actionCommand`	Строка команды действия, срабатываемая кнопкой.
`static final int`	`ARMED`	Идентифицирует бит "вооружён" в битовой маске, который указывает частичное подтверждение выбора/срабатывания кнопки.
`protected ChangeEvent`	`changeEvent`	Для каждой модели кнопки нужен только один `ChangeEvent`, поскольку состояние события определяется только свойством источника.
`static final int`	`ENABLED`	Идентифицирует бит "активный" в битовой маске, который указывает, что кнопку можно выбрать устройством ввода (таким как указатель мыши).
`protected ButtonGroup`	`group`	Группа кнопок, к которой принадлежит кнопка.
`protected EventListenerList`	`listenerList`	Хранит слушателей данной модели.
`protected int`	`mnemonic`	Мемо-символ кнопки.
`static final int`	`PRESSED`	Идентифицирует бит "нажата" в битовой маске, который указывает, что кнопка нажата.
`static final int`	`ROLLOVER`	Идентифицирует бит "наведение" в битовой маске, который указывает, что курсор мыши над кнопкой.
`static final int`	`SELECTED`	Идентифицирует бит "выбрана" в битовой маске, который указывает, что кнопка выбрана.
`protected int`	`stateMask`	Битовая маска, используемая для хранения состояния кнопки.

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

Конструктор	Описание
`DefaultButtonModel()`	Создаёт `DefaultButtonModel`.

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

Модификатор и тип	Метод	Описание
`void`	`addActionListener(ActionListener l)`	Добавляет `ActionListener` в модель.
`void`	`addChangeListener(ChangeListener l)`	Добавляет `ChangeListener` в модель.
`void`	`addItemListener(ItemListener l)`	Добавляет `ItemListener` в модель.
`protected void`	`fireActionPerformed(ActionEvent e)`	Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события.
`protected void`	`fireItemStateChanged(ItemEvent e)`	Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события.
`protected void`	`fireStateChanged()`	Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события.
`String`	`getActionCommand()`	Возвращает строку команды действия для кнопки.
`ActionListener[]`	`getActionListeners()`	Возвращает массив всех зарегистрированных слушателей действий на этом `DefaultButtonModel`.
`ChangeListener[]`	`getChangeListeners()`	Возвращает массив всех зарегистрированных слушателей изменений на этом `DefaultButtonModel`.
`ButtonGroup`	`getGroup()`	Возвращает группу, к которой принадлежит кнопка.
`ItemListener[]`	`getItemListeners()`	Возвращает массив всех зарегистрированных слушателей элементов на этом `DefaultButtonModel`.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, в настоящее время зарегистрированных как `FooListener` для этой модели.
`int`	`getMnemonic()`	Возвращает мемо-символ клавиатуры для кнопки.
`Object[]`	`getSelectedObjects()`	Переопределено для возвращения `null`.
`boolean`	`isArmed()`	Указывает частичное подтверждение срабатывания кнопки.
`boolean`	`isEnabled()`	Указывает, может ли кнопка быть выбрана или запущена устройством ввода, например, указателем мыши.
`boolean`	`isPressed()`	Указывает, нажата ли кнопка.
`boolean`	`isRollover()`	Указывает, что курсор мыши находится над кнопкой.
`boolean`	`isSelected()`	Указывает, выбрана ли кнопка.
`void`	`removeActionListener(ActionListener l)`	Удаляет `ActionListener` из модели.
`void`	`removeChangeListener(ChangeListener l)`	Удаляет `ChangeListener` из модели.
`void`	`removeItemListener(ItemListener l)`	Удаляет `ItemListener` из модели.
`void`	`setActionCommand(String actionCommand)`	Устанавливает строку команды действия, которая отправляется в качестве части `ActionEvent` при срабатывании кнопки.
`void`	`setArmed(boolean b)`	Отмечает кнопку как вооруженную или разоруженную.
`void`	`setEnabled(boolean b)`	Включает или выключает кнопку.
`void`	`setGroup(ButtonGroup group)`	Определяет группу, к которой принадлежит кнопка — требуется для радиокнопок, которые взаимоисключают друг друга в своей группе.
`void`	`setMnemonic(int key)`	Устанавливает мемо-символ клавиатуры (горячую клавишу или клавишу-ускоритель) для кнопки.
`void`	`setPressed(boolean b)`	Устанавливает кнопку как нажатую или ненажатую.
`void`	`setRollover(boolean b)`	Устанавливает или сбрасывает состояние наведения на кнопку.
`void`	`setSelected(boolean b)`	Выбирает или снимает выбор с кнопки.

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

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

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

stateMask

protected int stateMask

Маска битов, используемая для хранения состояния кнопки.

actionCommand

protected String actionCommand

Строка команды действия, генерируемая кнопкой.

group

protected ButtonGroup group

Группа кнопок, к которой принадлежит данная кнопка.

mnemonic

protected int mnemonic

Мемоик кнопки.

changeEvent

protected transient ChangeEvent changeEvent

Для каждой модели кнопки требуется только один ChangeEvent, так как состояние события определяется только свойством источника. Источником событий всегда является "this".

listenerList

protected EventListenerList listenerList

Хранит слушателей этой модели.

ARMED

public static final int ARMED

Идентифицирует бит "armed" в маске битов, указывающий на частичное подтверждение выбора/срабатывания кнопки.

См. также:

SELECTED

public static final int SELECTED

Идентифицирует бит "selected" в маске битов, указывающий на то, что кнопка выбрана. Требуется только для определённых типов кнопок - таких как радиокнопки или флажки.

См. также:

PRESSED

public static final int PRESSED

Идентифицирует бит "pressed" в маске битов, указывающий на нажатие кнопки.

См. также:

ENABLED

public static final int ENABLED

Идентифицирует бит "enabled" в маске битов, указывающий, что кнопку можно выбрать с помощью устройства ввода (например, курсора мыши).

См. также:

ROLLOVER

public static final int ROLLOVER

Идентифицирует бит "rollover" в маске битов, указывающий, что курсор мыши находится над кнопкой.

См. также:

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

DefaultButtonModel

public DefaultButtonModel()

Создаёт DefaultButtonModel.

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

setActionCommand

public void setActionCommand(String actionCommand)

Устанавливает строку команды действия, которая отправляется в составе ActionEvent при срабатывании кнопки.

Определено в:

setActionCommand в интерфейсе ButtonModel

Параметры:

actionCommand - строка, идентифицирующая сгенерированное событие

См. также:

getActionCommand

public String getActionCommand()

Возвращает строку команды действия для кнопки.

Определено в:

getActionCommand в интерфейсе ButtonModel

Возвращает:

строку, идентифицирующую сгенерированное событие

См. также:

isArmed

public boolean isArmed()

Указывает на частичное подтверждение срабатывания кнопки.

Определено в:

isArmed в интерфейсе ButtonModel

Возвращает:

true если кнопка вооружена и готова к срабатыванию

См. также:

isSelected

public boolean isSelected()

Указывает, выбрана ли кнопка. Необходимо только для определённых типов кнопок, таких как радиокнопки и флажки.

Определено в:: isSelected в интерфейсе ButtonModel
Возвращает:: true если кнопка выбрана

isEnabled

public boolean isEnabled()

Указывает, может ли кнопка быть выбрана или активирована устройством ввода, таким как курсор мыши.

Определено в:: isEnabled в интерфейсе ButtonModel
Возвращает:: true если кнопка активна

isPressed

public boolean isPressed()

Указывает, нажата ли кнопка.

Определено в:: isPressed в интерфейсе ButtonModel
Возвращает:: true если кнопка нажата

isRollover

public boolean isRollover()

Указывает, что курсор мыши находится над кнопкой.

Определено в:: isRollover в интерфейсе ButtonModel
Возвращает:: true если курсор мыши находится над кнопкой

setArmed

public void setArmed(boolean b)

Помечает кнопку как вооружённую или разряженную.

Определено в:: setArmed в интерфейсе ButtonModel
Параметры:: b - b ли кнопка должна быть вооружена

setEnabled

public void setEnabled(boolean b)

Включает или отключает кнопку.

Определено в:

setEnabled в интерфейсе ButtonModel

Параметры:

b - b ли кнопка должна быть включена

См. также:

setSelected

public void setSelected(boolean b)

Выбирает или отменяет выбор кнопки.

Определено в:: setSelected в интерфейсе ButtonModel
Параметры:: b - true выбирает кнопку, false отменяет выбор кнопки

setPressed

public void setPressed(boolean b)

Устанавливает состояние кнопки в нажатое или ненажатое.

Определено в:

setPressed в интерфейсе ButtonModel

Параметры:

b - b ли кнопка должна быть нажата

См. также:

setRollover

public void setRollover(boolean b)

Устанавливает или сбрасывает состояние наведения курсора на кнопку

Определено в:

setRollover в интерфейсе ButtonModel

Параметры:

b - b ли кнопка находится в состоянии наведения курсора

См. также:

setMnemonic

public void setMnemonic(int key)

Устанавливает мнемоническую клавишу (сочетание клавиш или клавишу быстрого доступа) для кнопки.

Определено в:: setMnemonic в интерфейсе ButtonModel
Параметры:: key - целое число, определяющее клавишу быстрого доступа

getMnemonic

public int getMnemonic()

Получает мнемоническую клавишу кнопки.

Определено в:

getMnemonic в интерфейсе ButtonModel

Возвращает:

целое число, определяющее клавишу быстрого доступа

См. также:

addChangeListener

public void addChangeListener(ChangeListener l)

Добавляет ChangeListener к модели.

Определено в:: addChangeListener в интерфейсе ButtonModel
Параметры:: l - слушатель для добавления

removeChangeListener

public void removeChangeListener(ChangeListener l)

Удаляет ChangeListener из модели.

Определено в:: removeChangeListener в интерфейсе ButtonModel
Параметры:: l - слушатель для удаления

getChangeListeners

public ChangeListener[] getChangeListeners()

Возвращает массив всех слушателей изменений, зарегистрированных на этом DefaultButtonModel.

Возвращает:

все слушатели изменений этой модели или пустой массив, если слушатели изменений в настоящее время не зарегистрированы

С тех пор:

1.4

См. также:

fireStateChanged

protected void fireStateChanged()

Уведомляет всех слушателей, которые проявили интерес к уведомлению об этом типе события. Экземпляр события создаётся лениво.

См. также:

addActionListener

public void addActionListener(ActionListener l)

Добавляет ActionListener к модели.

Определено в:: addActionListener в интерфейсе ButtonModel
Параметры:: l - слушатель для добавления

removeActionListener

public void removeActionListener(ActionListener l)

Удаляет ActionListener из модели.

Определено в:: removeActionListener в интерфейсе ButtonModel
Параметры:: l - слушатель для удаления

getActionListeners

public ActionListener[] getActionListeners()

Возвращает массив всех слушателей действий, зарегистрированных на этом DefaultButtonModel.

Возвращает:

все слушатели действий этой модели или пустой массив, если слушатели действий в настоящее время не зарегистрированы

С тех пор:

1.4

См. также:

fireActionPerformed

protected void fireActionPerformed(ActionEvent e)

Уведомляет всех слушателей, которые проявили интерес к уведомлению об этом типе события.

Параметры:

e - ActionEvent для передачи слушателям

См. также:

addItemListener

public void addItemListener(ItemListener l)

Добавляет ItemListener к модели.

Определено в:

addItemListener в интерфейсе ButtonModel

Определено в:

addItemListener в интерфейсе ItemSelectable

Параметры:

l - слушатель для добавления

См. также:

removeItemListener

public void removeItemListener(ItemListener l)

Удаляет ItemListener из модели.

Определено в:

removeItemListener в интерфейсе ButtonModel

Определено в:

removeItemListener в интерфейсе ItemSelectable

Параметры:

l - слушатель для удаления

См. также:

getItemListeners

public ItemListener[] getItemListeners()

Возвращает массив всех слушателей элементов, зарегистрированных на этом DefaultButtonModel.

Возвращает:

все слушатели элементов этой модели или пустой массив, если слушатели элементов в настоящее время не зарегистрированы

С тех пор:

1.4

См. также:

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent e)

Уведомляет всех слушателей, которые проявили интерес к уведомлению об этом типе события.

Параметры:

e - ItemEvent для передачи слушателям

См. также:

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

Возвращает массив всех объектов, в настоящее время зарегистрированных как FooListener на этой модели. FooListener регистрируются с помощью метода addFooListener.

Вы можете указать аргумент listenerType с помощью литерала класса, например, FooListener.class. Например, вы можете запросить у экземпляра DefaultButtonModel его слушателей действий с помощью следующего кода:

ActionListener[] als = (ActionListener[])(m.getListeners(ActionListener.class));

Если такие слушатели не существуют, этот метод возвращает пустой массив.

Параметры типа:

T - тип запрашиваемых слушателей

Параметры:

listenerType - тип запрашиваемых слушателей; этот параметр должен указывать интерфейс, который унаследован от java.util.EventListener

Возвращает:

массив всех объектов, зарегистрированных как FooListener на этой модели, или пустой массив, если такие слушатели не были добавлены

Исключение:

ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener

С тех пор:

1.3

См. также:

getSelectedObjects

public Object[] getSelectedObjects()

Переопределён для возвращения null.

Определено в:: getSelectedObjects в интерфейсе ItemSelectable
Возвращает:: список выбранных объектов или null

setGroup

public void setGroup(ButtonGroup group)

Идентифицирует группу, к которой принадлежит кнопка – необходимо для радиокнопок, которые взаимоисключаются в своей группе.

Определено в:: setGroup в интерфейсе ButtonModel
Параметры:: group - ButtonGroup, к которой принадлежит кнопка

getGroup

public ButtonGroup getGroup()

Возвращает группу, к которой принадлежит кнопка. Обычно используется с радиокнопками, которые взаимоисключают друг друга в своей группе.

Определено в:: getGroup в интерфейсе ButtonModel
Возвращает:: ButtonGroup к которой принадлежит кнопка
С тех пор:: 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/DefaultButtonModel.html