Spec-Zone.ru › OpenJDK 17

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

Since:
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 - строка, идентифицирующая сгенерированное событие
См. также:
  • 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 - int, определяющий клавишу-акселератор

getMnemonic

public int getMnemonic()
Возвращает мемоническую комбинацию клавиш кнопки.
Определено в:
getMnemonic в интерфейсе ButtonModel
Возвращает:
int, определяющий клавишу-акселератор
См. также:
  • 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 к модели.
Определено в:
addItemListener в интерфейсе ButtonModel
Определено в:
addItemListener в интерфейсе ItemSelectable
Параметры:
l - слушатель для добавления
См. также:
  • ItemEvent

removeItemListener

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

getItemListeners

public ItemListener[] getItemListeners()
Возвращает массив всех слушателей элементов, зарегистрированных на этом DefaultButtonModel.
Возвращает:
все слушатели элементов этой модели или пустой массив, если в настоящее время нет зарегистрированных слушателей элементов
С:
1.4
См. также:
  • addItemListener(java.awt.event.ItemListener)
  • removeItemListener(java.awt.event.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 его слушателей действий с помощью следующего кода: 

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 - группа, к которой относится кнопка

getGroup

public ButtonGroup getGroup()
Возвращает группу, к которой относится кнопка. Обычно используется с радиокнопками, которые взаимоисключаются в своей группе.
Определено в:
getGroup в интерфейсе ButtonModel
Возвращает:
группу, к которой относится кнопка
С:
1.3

© 1993, 2021, 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/17/docs/api/java.desktop/javax/swing/DefaultButtonModel.html

Spec-Zone.ru

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