如何使用操作

一个Action可以用来将功能和状态与组件分离。例如，如果您有两个或更多执行相同功能的组件，请考虑使用Action对象来实现该功能。Action对象是一个动作监听器，它不仅提供了动作事件处理，还提供了对动作事件触发组件（如工具栏按钮、菜单项、常见按钮和文本字段）状态的集中处理。动作可以处理的状态包括文本、图标、助记符、启用状态和选中状态。

通常使用setAction方法将一个动作附加到组件上。当在组件上调用setAction时会发生以下情况：

• 组件的状态被更新以与Action的状态相匹配。例如，如果设置了Action的文本和图标值，组件的文本和图标将设置为这些值。
• Action对象被注册为组件的动作监听器。
• 如果Action的状态发生变化，组件的状态会更新以与Action相匹配。例如，如果更改了动作的启用状态，所有附加到它的组件的启用状态都会与该动作匹配。

下面是创建执行相同功能的工具栏按钮和菜单项的示例：

Action leftAction = new LeftAction(); //LeftAction代码稍后会显示
...
button = new JButton(leftAction)
...
menuItem = new JMenuItem(leftAction);

要创建Action对象，通常创建一个AbstractAction的子类，然后实例化它。在子类中，您必须实现actionPerformed方法，以在发生动作事件时适当地作出反应。下面是创建和实例化AbstractAction子类的示例：

leftAction = new LeftAction("Go left", anIcon,
             "This is the left button.",
             new Integer(KeyEvent.VK_L));
...
class LeftAction extends AbstractAction {
    public LeftAction(String text, ImageIcon icon,
                      String desc, Integer mnemonic) {
        super(text, icon);
        putValue(SHORT_DESCRIPTION, desc);
        putValue(MNEMONIC_KEY, mnemonic);
    }
    public void actionPerformed(ActionEvent e) {
        displayResult("Action for first button/menu item", e);
    }
}

当上述代码创建的动作附加到按钮和菜单项时，按钮和菜单项将显示与动作相关联的文本和图标。按钮和菜单项上使用L字符作为助记符，并将其工具提示文本设置为SHORT_DESCRIPTION字符串，后跟助记键的表示。

例如，我们提供了一个简单的示例，ActionDemo.java，定义了三个动作。每个动作都附加到一个按钮和一个菜单项。由于为每个按钮的动作设置了助记值，按下键序列Alt-L激活左按钮，Alt-M激活中间按钮，Alt-R激活右按钮。左按钮的工具提示显示这是左按钮。Alt-L。所有这些配置都是自动进行的，程序不需要显式调用设置助记符或工具提示文本的方法。正如我们将在后面展示的，程序确实调用了设置按钮文本的方法，但只是为了避免使用动作已经设置的值。

当"Go left"操作被禁用时，用户所见如下：

禁用"Go left"操作的代码如下：

boolean selected = ...//如果操作应该启用，则为true；否则为false
leftAction.setEnabled(selected);

在使用Action创建组件后，您可能需要进行自定义。例如，您可能希望通过添加或删除图标或文本来自定义其中一个组件的外观。例如，ActionDemo.java的菜单中没有图标，按钮中也没有文本。下面的代码实现了这一点：

menuItem = new JMenuItem();
menuItem.setAction(leftAction);
menuItem.setIcon(null); //在菜单中不使用图标
...
button = new JButton();
button.setAction(leftAction);
button.setText(""); //仅有图标的按钮

我们选择通过将图标属性设置为null，将文本设置为空字符串，从而从同一个操作创建一个仅有图标的按钮和仅有文本的菜单项。然而，如果Action的属性发生更改，部件可能会尝试再次从Action中重置图标和文本。

Action API

以下表格列出了常用的Action构造函数和方法。使用Action对象的API分为三个类别：

• 支持set/getAction的组件
• 创建和使用AbstractAction
• 操作属性

动作属性

此表定义了可以在动作上设置的属性。第二列列出了自动使用这些属性的组件（以及具体调用的方法）。例如，将ACCELERATOR_KEY设置在附加到菜单项的动作上，意味着会自动调用JMenuItem.setAccelerator(KeyStroke)。

使用Actions的示例

以下示例使用Action对象。