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

Определяет бит «вооружено» в маске битов, который указывает на частичное принятие решения о выборе/активации кнопки.

См. также:

SELECTED

public static final int SELECTED

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

См. также:

PRESSED

public static final int PRESSED

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

См. также:

ENABLED

public static final int ENABLED

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

См. также:

ROLLOVER

public static final int 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 - активировать или деактивировать кнопку

setEnabled

public void setEnabled(boolean b)

Активирует или деактивирует кнопку.

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

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

Параметры:

b - активировать или деактивировать кнопку

См. также:

setSelected

public void setSelected(boolean b)

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

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

setPressed

public void setPressed(boolean b)

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

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

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

Параметры:

b - нажата ли кнопка

См. также:

setRollover

public void setRollover(boolean b)

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

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

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

Параметры:

b - находится ли указатель мыши над кнопкой

См. также:

setMnemonic

public void setMnemonic(int key)

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

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

getMnemonic

public int getMnemonic()

Возвращает мемоническую комбинацию символов для кнопки.

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

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

Возвращаемое значение:

целое число, определяющее клавишу ускорения

См. также:

addChangeListener

public void addChangeListener(ChangeListener l)

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

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

removeChangeListener

public void removeChangeListener(ChangeListener l)

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

Specified by:: removeChangeListener в интерфейсе ButtonModel
Parameters:: l - слушатель для удаления

getChangeListeners

public ChangeListener[] getChangeListeners()

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

Returns:

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

Since:

1.4

See Also:

fireStateChanged

protected void fireStateChanged()

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

See Also:

addActionListener

public void addActionListener(ActionListener l)

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

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

removeActionListener

public void removeActionListener(ActionListener l)

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

Specified by:: removeActionListener в интерфейсе ButtonModel
Parameters:: l - слушатель для удаления

getActionListeners

public ActionListener[] getActionListeners()

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

Returns:

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

Since:

1.4

See Also:

fireActionPerformed

protected void fireActionPerformed(ActionEvent e)

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

Parameters:

e - ActionEvent, который необходимо передать слушателям

See Also:

addItemListener

public void addItemListener(ItemListener l)

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

Specified by:

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

Specified by:

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

Parameters:

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

See Also:

removeItemListener

public void removeItemListener(ItemListener l)

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

Specified by:

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

Specified by:

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

Parameters:

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

See Also:

getItemListeners

public ItemListener[] getItemListeners()

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

Returns:

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

Since:

1.4

See Also:

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent e)

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

Parameters:

e - ItemEvent, который необходимо передать слушателям

See Also:

getListeners

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

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

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

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

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

Type Parameters:

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

Parameters:

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

Returns:

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

Throws:

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

Since:

1.3

See Also:

getSelectedObjects

public Object[] getSelectedObjects()

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

Specified by:: getSelectedObjects в интерфейсе ItemSelectable
Returns:: список выбранных объектов или null

setGroup

public void setGroup(ButtonGroup group)

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

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

getGroup

public ButtonGroup getGroup()

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

Specified by:: getGroup в интерфейсе ButtonModel
Returns:: ButtonGroup, к которой принадлежит кнопка
Since:: 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/DefaultButtonModel.html