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

Поля

Модификатор и тип	Поле и описание
`protected String`	`actionCommand` Строка команды действия, срабатывающая при нажатии кнопки.
`static int`	`ARMED` Идентифицирует бит «вооружен» в битовой маске, который указывает на частичное принятие решения о выборе/активации кнопки.
`protected ChangeEvent`	`changeEvent` Для каждой модели кнопки необходим только один `ChangeEvent`, так как состояние события зависит только от свойства источника.
`static int`	`ENABLED` Идентифицирует бит «активен» в битовой маске, указывающий, что кнопку можно выбрать с помощью устройства ввода (например, указателя мыши).
`protected ButtonGroup`	`group` Группа кнопок, к которой принадлежит кнопка.
`protected EventListenerList`	`listenerList` Содержит слушателей данной модели.
`protected int`	`mnemonic` Мемоик кнопки.
`static int`	`PRESSED` Идентифицирует бит «нажата» в битовой маске, который указывает, что кнопка нажата.
`static int`	`ROLLOVER` Идентифицирует бит «наведение» в битовой маске, который указывает, что курсор мыши находится над кнопкой.
`static 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, так как состояние события определяется только свойством source. Источником сгенерированных событий всегда является "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 - строка, идентифицирующая сгенерированное событие
См. также:: ButtonModel.getActionCommand(), ActionEvent.getActionCommand()

getActionCommand

public String getActionCommand()

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

Определено в:: getActionCommand в интерфейсе ButtonModel
Возвращает:: строку, идентифицирующую сгенерированное событие
См. также:: ButtonModel.setActionCommand(java.lang.String)

isArmed

public boolean isArmed()

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

Определено в:: isArmed в интерфейсе ButtonModel
Возвращает:: true , если кнопка активирована и готова к запуску
См. также:: ButtonModel.setArmed(boolean)

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 - нужно ли активировать кнопку

setEnabled

public void setEnabled(boolean b)

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

Определено в:: setEnabled в интерфейсе ButtonModel
Параметры:: b - нужно ли включить кнопку
См. также:: ButtonModel.isEnabled()

setSelected

public void setSelected(boolean b)

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

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

setPressed

public void setPressed(boolean b)

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

Определено в:: setPressed в интерфейсе ButtonModel
Параметры:: b - нужно ли нажать кнопку
См. также:: ButtonModel.isPressed()

setRollover

public void setRollover(boolean b)

Устанавливает или очищает состояние наведения указателя мыши на кнопку

Определено в:: setRollover в интерфейсе ButtonModel
Параметры:: b - находится ли указатель мыши над кнопкой
См. также:: ButtonModel.isRollover()

setMnemonic

public void setMnemonic(int key)

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

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

getMnemonic

public int getMnemonic()

Возвращает мемонику (горячую клавишу) кнопки.

Определено в:: getMnemonic в интерфейсе ButtonModel
Возвращает:: целочисленное значение, определяющее горячую клавишу
См. также:: ButtonModel.setMnemonic(int)

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
См. также:: addChangeListener(javax.swing.event.ChangeListener), removeChangeListener(javax.swing.event.ChangeListener)

fireStateChanged

protected void fireStateChanged()

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

См. также:: EventListenerList

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
См. также:: addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener)

fireActionPerformed

protected void fireActionPerformed(ActionEvent e)

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

Параметры:: e - ActionEvent для передачи слушателям
См. также:: EventListenerList

addItemListener

public void addItemListener(ItemListener l)

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

Specified by:: addItemListener в интерфейсе ItemSelectable
Specified by:: addItemListener в интерфейсе ButtonModel
Parameters:: l - слушатель для добавления
See Also:: ItemEvent

removeItemListener

public void removeItemListener(ItemListener l)

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

Specified by:: removeItemListener в интерфейсе ItemSelectable
Specified by:: removeItemListener в интерфейсе ButtonModel
Parameters:: l - слушатель для удаления
See Also:: ItemEvent

getItemListeners

public ItemListener[] getItemListeners()

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

Returns:: все слушатели событий изменения выбора этой модели или пустой массив, если слушатели не зарегистрированы
Since:: 1.4
See Also:: addItemListener(java.awt.event.ItemListener), removeItemListener(java.awt.event.ItemListener)

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent e)

Уведомляет всех слушателей о событии изменения состояния выбора.

Parameters:: e - событие ItemEvent для передачи слушателям
See Also:: EventListenerList

getListeners

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

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

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

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

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

Parameters:: listenerType - тип запрошенных слушателей; этот параметр должен указать интерфейс, который наследуется от java.util.EventListener
Returns:: массив всех объектов, зарегистрированных как FooListener для этой модели, или пустой массив, если такие слушатели не были добавлены
Throws:: ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener
Since:: 1.3
See Also:: getActionListeners(), getChangeListeners(), getItemListeners()

getSelectedObjects

public Object[] getSelectedObjects()

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

Specified by:: getSelectedObjects в интерфейсе ItemSelectable

setGroup

public void setGroup(ButtonGroup group)

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

Specified by:: setGroup в интерфейсе ButtonModel
Parameters:: group - группа, к которой принадлежит кнопка

getGroup

public ButtonGroup getGroup()

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

Returns:: группа, к которой принадлежит кнопка
Since:: 1.3

© 1993, 2020, 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.