Spec-Zone.ru › OpenJDK 21

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

getActionCommand

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

setGroup

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

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, 2023, 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/21/docs/api/java.desktop/javax/swing/ButtonModel.html

Spec-Zone.ru

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