Spec-Zone.ru › OpenJDK 17

Интерфейс ButtonModel

Все суперинтерфейсы:
ItemSelectable
Все известные реализующие классы:
DefaultButtonModel, JToggleButton.ToggleButtonModel
public interface ButtonModel extends ItemSelectable
Модель состояния для кнопок.

Эта модель используется для обычных кнопок, а также для флажков и радиокнопок, которые являются особыми видами кнопок. На практике, пользовательский интерфейс кнопки отвечает за вызов методов своей модели для управления состоянием, как подробно описано ниже:

Проще говоря, нажатие и отпускание мыши над обычной кнопкой активирует кнопку и вызывает и ActionEvent. То же самое поведение может быть воспроизведено с помощью клавиши клавиатуры, определенной внешним видом кнопки (как правило, это ПРОБЕЛ). Нажатие и отпускание этой клавиши, когда кнопка имеет фокус, даст тот же результат. Для флажков и радиокнопок последовательность нажатия и отпускания мыши или клавиатуры, описанная выше, приводит к выбору кнопки.

Подробно, модель состояния для кнопок работает следующим образом при использовании с мышью:
Нажатие мыши на кнопку делает модель как вооруженной, так и нажатой. Пока мышь нажата, модель остается нажатой, даже если мышь перемещается за пределы кнопки. Напротив, модель вооружена только пока мышь остается нажатой внутри границ кнопки (она может перемещаться внутрь или наружу кнопки, но модель вооружена только в течение той части времени, когда она находится внутри кнопки). Кнопка активируется, и ActionEvent генерируется, когда мышь отпускается, а модель вооружена — то есть когда она отпускается над кнопкой после того, как мышь была ранее нажата на эту кнопку (и не была уже отпущена). При отпускании мыши модель становится разоруженной и ненажатой.

Подробно, модель состояния для кнопок работает следующим образом при использовании с клавиатурой:
Нажатие клавиши клавиатуры, определенной внешним видом, когда кнопка имеет фокус, делает модель как вооруженной, так и нажатой. Пока эта клавиша нажата, модель остается в этом состоянии. Отпускание клавиши устанавливает модель в разоруженное и ненажатое состояние, активирует кнопку и вызывает ActionEvent.

С тех пор:
1.2

Краткое описание методов

Модификатор и тип Метод Описание
void addActionListener(ActionListener l)
Добавляет ActionListener в модель.
void addChangeListener(ChangeListener l)
Добавляет ChangeListener в модель.
void addItemListener(ItemListener l)
Добавляет ItemListener в модель.
String getActionCommand()
Возвращает строку команды действия для кнопки.
default ButtonGroup getGroup()
Возвращает группу, к которой принадлежит кнопка.
int getMnemonic()
Получает мнемонический код клавиатуры для кнопки.
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 s)
Устанавливает строку команды действия, которая отправляется как часть 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.awt.ItemSelectable

getSelectedObjects

Подробное описание методов

isArmed

boolean isArmed()
Указывает на частичное обязательство по запуску кнопки.
Возвращает:
true если кнопка вооружена и готова к запуску
См. также:
  • setArmed(boolean)

isSelected

boolean isSelected()
Указывает, выбрана ли кнопка. Необходимо только для определенных типов кнопок — таких как радиокнопки и флажки.
Возвращает:
true если кнопка выбрана

isEnabled

boolean isEnabled()
Указывает, можно ли выбрать или запустить кнопку с помощью устройства ввода, например, указателя мыши.
Возвращает:
true если кнопка активна

isPressed

boolean isPressed()
Указывает, нажата ли кнопка.
Возвращает:
true если кнопка нажата

isRollover

boolean isRollover()
Указывает, что указатель мыши находится над кнопкой.
Возвращает:
true если указатель мыши находится над кнопкой

setArmed

void setArmed(boolean b)
Помечает кнопку как вооруженную или разряженную.
Параметры:
b — нужно ли вооружать кнопку

setSelected

void setSelected(boolean b)
Выбирает или отменяет выбор кнопки.
Параметры:
b — true выбирает кнопку, false отменяет выбор кнопки

setEnabled

void setEnabled(boolean b)
Включает или отключает кнопку.
Параметры:
b — нужно ли включать кнопку
См. также:
  • isEnabled()

setPressed

void setPressed(boolean b)
Устанавливает кнопку в нажатое или ненажатое состояние.
Параметры:
b — нужно ли нажимать кнопку
См. также:
  • isPressed()

setRollover

void setRollover(boolean b)
Устанавливает или сбрасывает состояние наведения на кнопку
Параметры:
b — находится ли указатель мыши над кнопкой
См. также:
  • isRollover()

setMnemonic

void setMnemonic(int key)
Устанавливает мнемонический символ клавиатуры (сочетание клавиш или клавишу-акселератор) для кнопки.
Параметры:
key — целое число, определяющее клавишу-акселератор

getMnemonic

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

setActionCommand

void setActionCommand(String s)
Устанавливает строку команды действия, которая отправляется в качестве части ActionEvent, когда кнопка запускается.
Параметры:
s — String, который идентифицирует сгенерированное событие
См. также:
  • getActionCommand()
  • ActionEvent.getActionCommand()

getActionCommand

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

setGroup

void setGroup(ButtonGroup group)
Идентифицирует группу, к которой принадлежит кнопка — необходимо для радиокнопок, которые взаимоисключающие в своей группе.
Параметры:
group — ButtonGroup к которой принадлежит кнопка

getGroup

default ButtonGroup getGroup()
Возвращает группу, к которой принадлежит кнопка. Обычно используется с радиокнопками, которые взаимоисключающие в своей группе.
Требования к реализации:
Базовая реализация этого метода возвращает null. Подклассы должны возвращать группу, заданную с помощью setGroup().
Возвращает:
группа, к которой принадлежит кнопка
С:
10

addActionListener

void addActionListener(ActionListener l)
Добавляет ActionListener в модель.
Параметры:
l — слушатель для добавления

removeActionListener

void removeActionListener(ActionListener l)
Удаляет ActionListener из модели.
Параметры:
l — слушатель для удаления

addItemListener

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

removeItemListener

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

addChangeListener

void addChangeListener(ChangeListener l)
Добавляет ChangeListener в модель.
Параметры:
l — слушатель для добавления

removeChangeListener

void removeChangeListener(ChangeListener l)
Удаляет ChangeListener из модели.
Параметры:
l — слушатель для удаления

© 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/ButtonModel.html

Spec-Zone.ru

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