Интерфейс 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, если кнопка активирована и готова к нажатию

См. также:

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)

Добавляет слушателя событий к модели.

Параметры:: l - слушатель для добавления

removeActionListener

void removeActionListener(ActionListener l)

Удаляет слушателя событий из модели.

Параметры:: l - слушатель для удаления

addItemListener

void addItemListener(ItemListener l)

Добавляет слушателя событий к модели.

Определено в:

addItemListener в интерфейсе ItemSelectable

Параметры:

l - слушатель для добавления

См. также:

removeItemListener

void removeItemListener(ItemListener l)

Удаляет слушателя событий из модели.

Определено в:

removeItemListener в интерфейсе ItemSelectable

Параметры:

l - слушатель для удаления

См. также:

addChangeListener

void addChangeListener(ChangeListener l)

Добавляет слушателя изменений в модель.

Параметры:: l - слушатель для добавления

removeChangeListener

void removeChangeListener(ChangeListener l)

Удаляет слушателя изменений из модели.

Параметры:: l - слушатель для удаления

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/ButtonModel.html