Интерфейс ButtonModel

public interface ButtonModel
extends ItemSelectable

Модель состояния для кнопок.

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

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

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

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

Методы

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 - группа, к которой принадлежит кнопка

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 - слушатель для удаления