Интерфейс Action

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

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

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

Обратите внимание, что реализации интерфейса 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.

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

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