Интерфейс ButtonModel
- Все суперинтерфейсы:
ItemSelectable
- Все известные реализующие классы:
-
DefaultButtonModel,JToggleButton.ToggleButtonModel
public interface ButtonModel extends ItemSelectable
Эта модель используется для обычных кнопок, а также для флажков и радиокнопок, которые являются особыми видами кнопок. На практике, пользовательский интерфейс кнопки отвечает за вызов методов своей модели для управления состоянием, как подробно описано ниже:
Проще говоря, нажатие и отпускание мыши над обычной кнопкой активирует кнопку и вызывает и ActionEvent . То же поведение может быть вызвано нажатием клавиши, определенной внешним видом кнопки (обычно клавишей ПРОБЕЛ). Нажатие и отпускание этой клавиши, когда у кнопки есть фокус, даст тот же результат. Для флажков и радиокнопок последовательность действий с мышью или клавиатурой, описанная выше, приводит к тому, что кнопка становится выбранной.
Подробно, модель состояния для кнопок работает следующим образом при использовании с мышью:
Нажатие мыши на кнопку делает модель как вооружённой, так и нажатой. Пока кнопка нажата, модель остаётся нажатой, даже если мышь перемещается за пределы кнопки. Напротив, модель вооружена только пока мышь остается нажатой внутри границ кнопки (она может перемещаться внутрь или наружу кнопки, но модель вооружена только в течение того периода времени, когда она находится внутри кнопки). Кнопка активируется, и ActionEvent , когда мышь отпускается, когда модель вооружена - то есть когда она отпускается над кнопкой после предыдущего нажатия на эту кнопку (и не была уже отпущена). При отпускании мыши модель становится безоружной и ненажатой.
Подробно, модель состояния для кнопок работает следующим образом при использовании с клавиатурой:
Нажатие клавиши, определённой внешним видом, в то время, когда у кнопки есть фокус, делает модель как вооружённой, так и нажатой. Пока эта клавиша нажата, модель остаётся в этом состоянии. Отпускание клавиши устанавливает модель в безоружное и ненажатое состояние, активирует кнопку и вызывает ActionEvent .
- С момента:
- 1.2
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addActionListener |
Добавляет ActionListener в модель. |
void |
addChangeListener |
Добавляет ChangeListener в модель. |
void |
addItemListener |
Добавляет ItemListener в модель. |
String |
getActionCommand() |
Возвращает строку команды действия для кнопки. |
default ButtonGroup |
getGroup() |
Возвращает группу, к которой принадлежит кнопка. |
int |
getMnemonic() |
Получает мнемонический символ клавиатуры для кнопки. |
boolean |
isArmed() |
Указывает частичное выполнение действия по нажатию кнопки. |
boolean |
isEnabled() |
Указывает, может ли кнопка быть выбрана или активирована устройством ввода, например, указателем мыши. |
boolean |
isPressed() |
Указывает, нажата ли кнопка. |
boolean |
isRollover() |
Указывает, что мышь находится над кнопкой. |
boolean |
isSelected() |
Указывает, выбрана ли кнопка. |
void |
removeActionListener |
Удаляет ActionListener из модели. |
void |
removeChangeListener |
Удаляет ChangeListener из модели. |
void |
removeItemListener |
Удаляет ItemListener из модели. |
void |
setActionCommand |
Устанавливает строку команды действия, которая отправляется как часть ActionEvent при нажатии кнопки. |
void |
setArmed |
Помечает кнопку как вооружённую или безоружную. |
void |
setEnabled |
Включает или выключает кнопку. |
void |
setGroup |
Определяет группу, к которой принадлежит кнопка (необходимо для радиокнопок, которые являются взаимоисключающими в своей группе). |
void |
setMnemonic |
Устанавливает мнемонический символ клавиатуры (сочетание клавиш или клавишу быстрого доступа) для кнопки. |
void |
setPressed |
Устанавливает кнопку в нажатое или ненажатое состояние. |
void |
setRollover |
Устанавливает или очищает состояние наведения на кнопку |
void |
setSelected |
Выбирает или отменяет выбор кнопки. |
Методы, объявленные в интерфейсе java.awt.ItemSelectable
getSelectedObjects
Подробное описание методов
isArmed
boolean isArmed()
- Возвращает:
-
trueесли кнопка вооружена и готова к срабатыванию - См. также:
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- является ли кнопка активной - См. также:
setPressed
void setPressed(boolean b)
- Параметры:
-
b- является ли кнопка нажатой - См. также:
setRollover
void setRollover(boolean b)
- Параметры:
-
b- находится ли указатель мыши над кнопкой - См. также:
setMnemonic
void setMnemonic(int key)
- Параметры:
-
key- целое число, определяющее клавишу ускорения
getMnemonic
int getMnemonic()
- Возвращает:
- целое число, определяющее клавишу ускорения
- См. также:
setActionCommand
void setActionCommand(String s)
ActionEvent, когда кнопка нажимается.- Параметры:
-
s- строка, идентифицирующая сгенерированное событие - См. также:
getActionCommand
String getActionCommand()
- Возвращает:
- строка, идентифицирующая сгенерированное событие
- См. также:
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- слушатель для добавления - См. также:
removeItemListener
void removeItemListener(ItemListener l)
ItemListener из модели.- Определяется в:
-
removeItemListenerв интерфейсеItemSelectable - Параметры:
-
l- слушатель для удаления - См. также:
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