Spec-Zone.ru › OpenJDK 25

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

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

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, идентифицирующая сгенерированное событие
См. также:
  • ButtonModel.getActionCommand()
  • ActionEvent.getActionCommand()

getActionCommand

public String getActionCommand()
Возвращает строку команды действия для кнопки.
Определено в:
getActionCommand в интерфейсе ButtonModel
Возвращает:
String, идентифицирующую сгенерированное событие
См. также:
  • ButtonModel.setActionCommand(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.
Возвращает:
все ChangeListener этой модели или пустой массив, если слушатели изменений не зарегистрированы
С версии:
1.4
См. также:
  • addChangeListener(ChangeListener)
  • removeChangeListener(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.
Возвращает:
все ActionListener этой модели или пустой массив, если слушатели действий не зарегистрированы
С версии:
1.4
См. также:
  • addActionListener(ActionListener)
  • removeActionListener(ActionListener)

fireActionPerformed

protected void fireActionPerformed(ActionEvent e)
Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям об этом типе событий.
Параметры:
e — ActionEvent, которое будет передано слушателям
См. также:
  • EventListenerList

addItemListener

public void addItemListener(ItemListener l)
Добавляет ItemListener в модель.
Определено в:
addItemListener в интерфейсе ButtonModel
Определено в:
addItemListener в интерфейсе ItemSelectable
Параметры:
l — добавляемый слушатель
См. также:
  • ItemEvent

removeItemListener

public void removeItemListener(ItemListener l)
Удаляет ItemListener из модели.
Определено в:
removeItemListener в интерфейсе ButtonModel
Определено в:
removeItemListener в интерфейсе ItemSelectable
Параметры:
l — удаляемый слушатель
См. также:
  • ItemEvent

getItemListeners

public ItemListener[] getItemListeners()
Возвращает массив всех слушателей элементов, зарегистрированных в этой DefaultButtonModel.
Возвращает:
все ItemListener этой модели или пустой массив, если слушатели элементов не зарегистрированы
С версии:
1.4
См. также:
  • addItemListener(ItemListener)
  • removeItemListener(ItemListener)

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent e)
Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям об этом типе событий.
Параметры:
e — ItemEvent, которое будет передано слушателям
См. также:
  • 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));
Если таких слушателей нет, этот метод возвращает пустой массив.
Параметры типа:
T — тип запрашиваемых слушателей
Параметры:
listenerType — тип запрашиваемых слушателей; этот параметр должен задавать интерфейс, производный от java.util.EventListener
Возвращает:
массив всех объектов, зарегистрированных в этой модели как FooListener, или пустой массив, если такие слушатели не добавлялись
Выбрасывает:
ClassCastException — если listenerType не задает класс или интерфейс, реализующий java.util.EventListener
С версии:
1.3
См. также:
  • getActionListeners()
  • getChangeListeners()
  • getItemListeners()

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

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, включая концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/DefaultButtonModel.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API