Интерфейс 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, поддерживающими Actions. В таблице, кнопка относится к любому подклассу AbstractButton, что включает не только JButton, но и такие классы, как JMenuItem. Если не указано иное, значение свойства null в объекте Action (или Action, который null ), приводит к установке соответствующего свойства кнопки в значение null.

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

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