Класс 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 в пакете java.beans добавлена поддержка долгосрочного хранения всех JavaBeans. См. 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)`	Выбирает или снимает выбор с кнопки.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.

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

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 — String, идентифицирующая созданное событие

См. также:

getActionCommand

public String getActionCommand()

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

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

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

Возвращает:

String, идентифицирующую созданное событие

См. также:

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 к модели.

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

removeChangeListener

public void removeChangeListener(ChangeListener l)

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

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

getChangeListeners

public ChangeListener[] getChangeListeners()

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

Возвращает:

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

Начиная с версии:

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.

Возвращает:

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

Начиная с версии:

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.

Возвращает:

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

Начиная с версии:

1.4

См. также:

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent e)

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

Параметры:

e — ItemEvent, отправляемое слушателям

См. также:

getListeners

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

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

Выбрасывает:

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