Интерфейс 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—String, который идентифицирует сгенерированное событие - См. также:
getActionCommand
String getActionCommand()
- Возвращает:
- строку, которая идентифицирует сгенерированное событие
- См. также:
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— слушатель для добавления - См. также:
removeItemListener
void removeItemListener(ItemListener l)
ItemListener из модели.- Определено в:
-
removeItemListenerв интерфейсеItemSelectable - Параметры:
-
l— слушатель для удаления - См. также:
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