Интерфейс Action

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

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

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

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

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

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

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

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

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

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