Интерфейс Action

public interface Action
extends ActionListener

Интерфейс Action предоставляет полезное расширение интерфейса ActionListener в тех случаях, когда к одной и той же функциональности могут получить доступ несколько элементов управления.

В дополнение к методу actionPerformed, определенному интерфейсом ActionListener, этот интерфейс позволяет приложению определить в одном месте:

• Одну или несколько текстовых строк, описывающих функцию. Эти строки могут быть использованы, например, для отображения всплывающего текста для кнопки или для установки текста в пункте меню.
• Один или несколько значков, изображающих функцию. Эти значки могут использоваться для изображений в элементе управления меню или для составных записей в более сложном пользовательском интерфейсе.
• Состояние включения/выключения функциональности. Вместо того, чтобы отдельно отключать пункт меню и кнопку на панели инструментов, приложение может отключить функцию, реализующую этот интерфейс. Все компоненты, зарегистрированные как слушатели изменения состояния, затем знают, как отключить генерацию событий для этого элемента и соответствующим образом изменить отображение.

Этот интерфейс может быть добавлен к существующему классу или использован для создания адаптера (как правило, путем наследования от AbstractAction). Объект Action затем может быть добавлен в несколько контейнеров, поддерживающих Action, и подключен к компонентам, способным обрабатывать Action. Элементы управления графическим интерфейсом пользователя затем могут быть активированы или деактивированы все сразу путем вызова метода Action объекта setEnabled.

Обратите внимание, что реализации Action имеют тенденцию быть более дорогими с точки зрения хранения, чем типичный ActionListener, который не предлагает преимущества централизованного управления функциональностью и трансляции изменений свойств. По этой причине следует с осторожностью использовать Action только в тех случаях, когда необходимы их преимущества, и использовать простые ActionListener в других случаях.

Компоненты Swing, поддерживающие Action

Многие компоненты Swing имеют свойство Action. Когда Action задается для компонента, происходит следующее:

• Action добавляется как слушатель ActionListener к компоненту.
• Компонент настраивает некоторые свои свойства, чтобы соответствовать Action.
• Компонент устанавливает слушателя PropertyChangeListener на Action, чтобы компонент мог изменять свои свойства в ответ на изменения свойств Action.

В следующей таблице описаны свойства, используемые компонентами Swing , поддерживающими Actions. В таблице кнопка относится к любому подклассу AbstractButton, включая не только JButton, но и классы, такие как JMenuItem. Если не указано иное, значение свойства null в Action (или в Action, который является null приводит к установке соответствующего свойства кнопки в null.

Свойство компонента	Компоненты	Ключ Action	Примечания
enabled	Все	Метод isEnabled
toolTipText	Все	SHORT_DESCRIPTION
actionCommand	Все	ACTION_COMMAND_KEY
mnemonic	Все кнопки	MNEMONIC_KEY	Значение null или Action приводит к установке свойства mnemonic кнопки в '\0'.
text	Все кнопки	NAME	Если вы не хотите, чтобы текст кнопки отражал текст Action, установите свойство hideActionText в true. Если hideActionText имеет значение true, установка Action изменяет текст кнопки на null, а любые изменения в NAME игнорируются. hideActionText полезно для кнопок панели инструментов, которые обычно отображают только Icon. JToolBar.add(Action) устанавливает свойство в true, если Action имеет значение, отличное от null, для LARGE_ICON_KEY или SMALL_ICON.
displayedMnemonicIndex	Все кнопки	DISPLAYED_MNEMONIC_INDEX_KEY	Если значение DISPLAYED_MNEMONIC_INDEX_KEY выходит за пределы текста, оно игнорируется. При вызове setAction, если значение из Action равно null, индекс отображаемого символа-мнемоники не обновляется. При последующих изменениях в DISPLAYED_MNEMONIC_INDEX_KEY, null обрабатывается как -1.
icon	Все кнопки, кроме JCheckBox, JToggleButton и JRadioButton.	либо LARGE_ICON_KEY, либо SMALL_ICON	Подклассы JMenuItem используют только SMALL_ICON. Все остальные кнопки будут использовать LARGE_ICON_KEY; если значение равно null, они будут использовать SMALL_ICON.
accelerator	Все подклассы JMenuItem, за исключением JMenu.	ACCELERATOR_KEY
selected	JToggleButton, JCheckBox, JRadioButton, JCheckBoxMenuItem и JRadioButtonMenuItem	SELECTED_KEY	Компоненты, которые обрабатывают это свойство, используют значение только если оно non-null. Например, если вы установите Action, у которого есть значение null для SELECTED_KEY на JToggleButton, JToggleButton не будет обновлять свое состояние выделения никоим образом. Аналогично, всякий раз, когда состояние выделения JToggleButton меняется, оно будет устанавливать значение обратно в Action только если Action имеет значение non-null для SELECTED_KEY. Компоненты, которые обрабатывают это свойство, поддерживают синхронизацию своего состояния выделения с этим свойством. Когда один и тот же Action используется с несколькими компонентами, все компоненты поддерживают синхронизацию состояния выделения с этим свойством. Взаимоисключающие кнопки, такие как JToggleButton в ButtonGroup, вынуждают только одну кнопку быть выделенной. Поэтому не используйте один и тот же Action, определяющий значение для свойства SELECTED_KEY, с несколькими взаимоисключающими кнопками.

JPopupMenu, JToolBar и JMenu предоставляют удобные методы для создания компонента и установки Action на соответствующий компонент. Обратитесь к каждому из этих классов для получения дополнительной информации.

Action использует PropertyChangeListener для уведомления слушателей об изменении Action. Спецификация бинов указывает, что имя свойства null может быть использовано для указания того, что изменилось несколько значений. По умолчанию компоненты Swing, которые принимают Action , не обрабатывают такое изменение. Чтобы указать, что Swing должен обрабатывать null в соответствии со спецификацией бинов, установите системную переменную swing.actions.reconfigureOnNull в значение String true.