Action (Java Platform SE 8 )

All Superinterfaces:: ActionListener， EventListener

所有已知实现类：: AbstractAction， BasicDesktopPaneUI.CloseAction， BasicDesktopPaneUI.MaximizeAction， BasicDesktopPaneUI.MinimizeAction， BasicDesktopPaneUI.NavigateAction， BasicDesktopPaneUI.OpenAction， BasicFileChooserUI.ApproveSelectionAction， BasicFileChooserUI.CancelSelectionAction， BasicFileChooserUI.ChangeToParentDirectoryAction， BasicFileChooserUI.GoHomeAction， BasicFileChooserUI.NewFolderAction， BasicFileChooserUI.UpdateAction， BasicInternalFrameTitlePane.CloseAction， BasicInternalFrameTitlePane.IconifyAction， BasicInternalFrameTitlePane.MaximizeAction， BasicInternalFrameTitlePane.MoveAction， BasicInternalFrameTitlePane.RestoreAction， BasicInternalFrameTitlePane.SizeAction， BasicSliderUI.ActionScroller， BasicTreeUI.TreeCancelEditingAction， BasicTreeUI.TreeHomeAction， BasicTreeUI.TreeIncrementAction， BasicTreeUI.TreePageAction， BasicTreeUI.TreeToggleAction， BasicTreeUI.TreeTraverseAction， DefaultEditorKit.BeepAction， DefaultEditorKit.CopyAction， DefaultEditorKit.CutAction， DefaultEditorKit.DefaultKeyTypedAction， DefaultEditorKit.InsertBreakAction， DefaultEditorKit.InsertContentAction， DefaultEditorKit.InsertTabAction， DefaultEditorKit.PasteAction， HTMLEditorKit.HTMLTextAction， HTMLEditorKit.InsertHTMLTextAction， MetalFileChooserUI.DirectoryComboBoxAction， StyledEditorKit.AlignmentAction， StyledEditorKit.BoldAction， StyledEditorKit.FontFamilyAction， StyledEditorKit.FontSizeAction， StyledEditorKit.ForegroundAction， StyledEditorKit.ItalicAction， StyledEditorKit.StyledTextAction， StyledEditorKit.UnderlineAction， TextAction

public interface Action
extends ActionListener

的 Action接口提供了一个有用的扩展， ActionListener接口的情况下，相同的功能可以由几个控件访问。

除了由ActionListener接口中定义的actionPerformed方法，该接口允许应用程序定义的，在一个地方：

描述函数的一个或多个文本字符串。这些字符串可以使用，例如，为一个按钮或菜单项中设置文本显示文本的天桥。
描述函数的一个或多个图标。这些图标可以用于在菜单控件中的图像，或在一个更复杂的用户界面的复合条目。
功能的启用/禁用状态。而不是必须单独禁用菜单项和工具栏按钮，应用程序可以禁用实现此接口的功能。已注册为状态更改的侦听器的所有组件，然后知道要禁用该项目的事件生成，并相应地修改显示。

该接口可以为已有的类添加或用于创建一个适配器（通常情况下，通过子类化AbstractAction）。然后Action对象可以被添加到多个Action-aware容器和连接Action-capable组件。GUI控件就可以激活或停用一次通过调用对象的方法Action setEnabled。

注意，Action实现往往在存储方面是更昂贵的比一个典型的ActionListener，它不提供对性能变化的功能和广播集中控制的好处。出于这个原因，你应该照顾他们的利益Actions只使用需要，使用简单的ActionListeners别处。

swing零部件配套`Action`

许多Swing的组件有一个Action财产。当一个Action上设置的一个组成部分，以下的事情发生：

的Action作为ActionListener到组件。
组件配置了它的一些性质相匹配的Action。
组件安装在Action一PropertyChangeListener使组件可以改变其属性反映在Action性质发生改变。

下表描述了由Swing组件支持Actions使用性能。在餐桌上，按钮是指任何AbstractButton亚纲，其中不仅包括JButton也类如JMenuItem。除非另有说明，在Action一null属性值（或Action，null）在按钮的属性被设置为null结果。

Component Property	Components	Action Key	Notes
`enabled`	All	The `isEnabled` method
`toolTipText`	All	`SHORT_DESCRIPTION`
`actionCommand`	All	`ACTION_COMMAND_KEY`
`mnemonic`	All buttons	`MNEMONIC_KEY`	A `null` value or `Action` results in the button's `mnemonic` property being set to `'\0'`.
`text`	All buttons	`NAME`	If you do not want the text of the button to mirror that of the `Action`, set the property `hideActionText` to `true`. If `hideActionText` is `true`, setting the `Action` changes the text of the button to `null` and any changes to `NAME` are ignored. `hideActionText` is useful for tool bar buttons that typically only show an `Icon`. `JToolBar.add(Action)` sets the property to `true` if the `Action` has a non-`null` value for `LARGE_ICON_KEY` or `SMALL_ICON`.
`displayedMnemonicIndex`	All buttons	`DISPLAYED_MNEMONIC_INDEX_KEY`	If the value of `DISPLAYED_MNEMONIC_INDEX_KEY` is beyond the bounds of the text, it is ignored. When `setAction` is called, if the value from the `Action` is `null`, the displayed mnemonic index is not updated. In any subsequent changes to `DISPLAYED_MNEMONIC_INDEX_KEY`, `null` is treated as -1.
`icon`	All buttons except of `JCheckBox`, `JToggleButton` and `JRadioButton`.	either `LARGE_ICON_KEY` or `SMALL_ICON`	The `JMenuItem` subclasses only use `SMALL_ICON`. All other buttons will use `LARGE_ICON_KEY`; if the value is `null` they use `SMALL_ICON`.
`accelerator`	All `JMenuItem` subclasses, with the exception of `JMenu`.	`ACCELERATOR_KEY`
`selected`	`JToggleButton`, `JCheckBox`, `JRadioButton`, `JCheckBoxMenuItem` and `JRadioButtonMenuItem`	`SELECTED_KEY`	Components that honor this property only use the value if it is `non-null`. For example, if you set an `Action` that has a `null` value for `SELECTED_KEY` on a `JToggleButton`, the `JToggleButton` will not update it's selected state in any way. Similarly, any time the `JToggleButton`'s selected state changes it will only set the value back on the `Action` if the `Action` has a `non-null` value for `SELECTED_KEY`. Components that honor this property keep their selected state in sync with this property. When the same `Action` is used with multiple components, all the components keep their selected state in sync with this property. Mutually exclusive buttons, such as `JToggleButton`s in a `ButtonGroup`, force only one of the buttons to be selected. As such, do not use the same `Action` that defines a value for the `SELECTED_KEY` property with multiple mutually exclusive buttons.

JPopupMenu，JToolBar和JMenu都提供方便的方法创建组件和相应的组件设置Action。参考这些类的每一个，以了解更多信息。

Action使用PropertyChangeListener告知听众Action已经改变。豆子的规范表示null属性名称可以用来表示多个值已经改变了。默认情况下，Swing组件以Action不应对这种变化。表明摆动应该null根据豆规范设置系统属性的值true String swing.actions.reconfigureOnNull。

另请参见：: AbstractAction

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`ACCELERATOR_KEY` 用于存储 `KeyStroke`作为加速器的关键作用。
`static String`	`ACTION_COMMAND_KEY` 主要用于确定命令 `String`为 `ActionEvent`将会创造一个 `Action`时将居住在一个 `JComponent`相关 `Keymap`结果通知。
`static String`	`DEFAULT` 目前不使用。
`static String`	`DISPLAYED_MNEMONIC_INDEX_KEY` 用于存储 `Integer`对应的索引文本的关键（由 `NAME`属性确定），一个记忆的装饰应渲染。
`static String`	`LARGE_ICON_KEY` 用于存储 `Icon`关键。
`static String`	`LONG_DESCRIPTION` 用于存储更长的 `String`描述动作的关键，可以用于上下文敏感的帮助。
`static String`	`MNEMONIC_KEY` 用于存储 `Integer`，对应的一个 `KeyEvent`关键代码的关键。
`static String`	`NAME` 用于存储 `String`动作名称的密钥，使用菜单或按钮。
`static String`	`SELECTED_KEY` 用于存储 `Boolean`对应于选定状态的关键。
`static String`	`SHORT_DESCRIPTION` 用于存储短 `String`描述动作的关键，用于工具提示文本。
`static String`	`SMALL_ICON` 用于存储一个小 `Icon`的关键，如 `ImageIcon`。

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`void`	`addPropertyChangeListener(PropertyChangeListener listener)` 增加了一个 `PropertyChange`听众。
`Object`	`getValue(String key)` 使用关联的键获取此对象的属性之一。
`boolean`	`isEnabled()` 返回的 `Action`启用状态。
`void`	`putValue(String key, Object value)` 使用关联密钥设置此对象的属性之一。
`void`	`removePropertyChangeListener(PropertyChangeListener listener)` 删除一个 `PropertyChange`听众。
`void`	`setEnabled(boolean b)` 套的 `Action`启用状态。

Methods inherited from interface java.awt.event.ActionListener
actionPerformed

- Field Detail
  - DEFAULT
```
static final String DEFAULT
```
    目前不使用。
    
    另请参见：
    
    Constant Field Values
  - NAME
```
static final String NAME
```
    用于存储 String动作名称的密钥，使用菜单或按钮。
    
    另请参见：
    
    Constant Field Values
  - SHORT_DESCRIPTION
```
static final String SHORT_DESCRIPTION
```
    用于存储短 String描述动作的关键，用于工具提示文本。
    
    另请参见：
    
    Constant Field Values
  - LONG_DESCRIPTION
```
static final String LONG_DESCRIPTION
```
    用于存储更长的 String描述动作的关键，可以用于上下文敏感的帮助。
    
    另请参见：
    
    Constant Field Values
  - SMALL_ICON
```
static final String SMALL_ICON
```
    用于存储一个小 Icon的关键，如 ImageIcon。这通常是用于菜单如 JMenuItem。
    如果同样的Action使用的菜单和按钮，你通常会指定一个SMALL_ICON和LARGE_ICON_KEY。菜单将使用SMALL_ICON和按钮将使用LARGE_ICON_KEY。
    
    另请参见：
    
    Constant Field Values
  - ACTION_COMMAND_KEY
```
static final String ACTION_COMMAND_KEY
```
    主要用于确定命令 String为 ActionEvent将会创造一个 Action时将居住在一个 JComponent相关 Keymap结果通知。
    
    另请参见：
    
    Constant Field Values
  - ACCELERATOR_KEY
```
static final String ACCELERATOR_KEY
```
    用于存储 KeyStroke作为加速器的关键作用。
    
    从以下版本开始：
    
    一点三
    
    另请参见：
    
    Constant Field Values
  - MNEMONIC_KEY
```
static final String MNEMONIC_KEY
```
    用于存储 Integer，对应的一个 KeyEvent关键代码的关键。该值通常用于指定一个记忆。例如： myAction.putValue(Action.MNEMONIC_KEY, KeyEvent.VK_A)套 myAction '一'的记忆，而 myAction.putValue(Action.MNEMONIC_KEY, KeyEvent.getExtendedKeyCodeForChar('?'))套 myAction记忆以斯拉夫字母“EF”。
    
    从以下版本开始：
    
    一点三
    
    另请参见：
    
    Constant Field Values
  - SELECTED_KEY
```
static final String SELECTED_KEY
```
    用于存储 Boolean对应于选定状态的关键。这是通常只用于有一个有意义的选择状态的组件。例如， JRadioButton和 JCheckBox利用但不 JMenu
    此属性与其他属性不同，它是由组件读取的，并由组件设置的。例如，如果一个Action是连接到一个JCheckBox的JCheckBox选定状态将从该Action。如果在JCheckBox的JCheckBox选定状态和的Action将二者都更新用户点击。
    
    注：此字段的值的前缀是“摇摆”以避免可能的冲突与现有的Actions。
    实例
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    Constant Field Values
  - DISPLAYED_MNEMONIC_INDEX_KEY
```
static final String DISPLAYED_MNEMONIC_INDEX_KEY
```
    用于存储 Integer对应的索引文本的关键（由 NAME属性确定），一个记忆的装饰应渲染。如果此属性的值大于或等于文本的长度，则将视为- 1。
    注：此字段的值的前缀是“摇摆”以避免可能的冲突与现有的Actions。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    AbstractButton.setDisplayedMnemonicIndex(int)， Constant Field Values
  - LARGE_ICON_KEY
```
static final String LARGE_ICON_KEY
```
    用于存储 Icon的关键。这是通常使用的按钮，如 JButton和 JToggleButton。
    如果同样的Action使用的菜单和按钮，你通常会指定一个SMALL_ICON和LARGE_ICON_KEY。菜单将使用SMALL_ICON和按钮的LARGE_ICON_KEY。
    
    注：此字段的值的前缀是“摇摆”以避免可能的冲突与现有的Actions。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    Constant Field Values
- 方法详细信息
  - getValue
```
Object getValue(String key)
```
    使用关联的键获取此对象的属性之一。
    
    另请参见：
    
    putValue(java.lang.String, java.lang.Object)
  - putValue
```
void putValue(String key,
              Object value)
```
    使用关联密钥设置此对象的属性之一。如果值发生了变化，一 PropertyChangeEvent送给听众。
    
    参数
    
    key - String含有关键
    
    value - Object价值
  - setEnabled
```
void setEnabled(boolean b)
```
    套的 Action启用状态。当启用时，与该对象相关的任何部分是积极的、能火这个对象的 actionPerformed方法。如果值发生了变化，一 PropertyChangeEvent送给听众。
    
    参数
    
    b真正使这 Action，假禁用它
  - isEnabled
```
boolean isEnabled()
```
    返回的 Action启用状态。当启用时，与该对象相关的任何部分是积极的、能火这个对象的 actionPerformed方法。
    
    结果
    
    如果这 Action启用
  - addPropertyChangeListener
```
void addPropertyChangeListener(PropertyChangeListener listener)
```
    增加了一个 PropertyChange听众。容器和附加组件使用这些方法来登记本 Action对象的兴趣。当它的启用状态或其他属性更改时，注册的侦听器被通知更改。
    
    参数
    
    listener - PropertyChangeListener对象
  - removePropertyChangeListener
```
void removePropertyChangeListener(PropertyChangeListener listener)
```
    删除一个 PropertyChange听众。
    
    参数
    
    listener - PropertyChangeListener对象
    
    另请参见：
    
    addPropertyChangeListener(java.beans.PropertyChangeListener)

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface Action

swing零部件配套Action

Field Summary

方法摘要

Methods inherited from interface java.awt.event.ActionListener

Field Detail

DEFAULT

NAME

SHORT_DESCRIPTION

LONG_DESCRIPTION

SMALL_ICON

ACTION_COMMAND_KEY

ACCELERATOR_KEY

MNEMONIC_KEY

SELECTED_KEY

DISPLAYED_MNEMONIC_INDEX_KEY

LARGE_ICON_KEY

方法详细信息

getValue

putValue

setEnabled

isEnabled

addPropertyChangeListener

removePropertyChangeListener

swing零部件配套`Action`