JavaTM Platform
Standard Ed. 6

接口 javax.swing.Action
的使用

使用 Action 的软件包
javax.swing 提供一组“轻量级”(全部是 Java 语言)组件,尽量让这些组件在所有平台上的工作方式都相同。 
javax.swing.plaf.basic 提供了根据基本外观构建的用户界面对象。 
javax.swing.plaf.metal 提供根据 Java 外观(曾经代称为 Metal)构建的用户界面对象,Java 外观是默认外观。 
javax.swing.text 提供类 HTMLEditorKit 和创建 HTML 文本编辑器的支持类。 
javax.swing.text.html 提供类 HTMLEditorKit 和创建 HTML 文本编辑器的支持类。 
 

javax.swingAction 的使用
 

实现 Actionjavax.swing 中的类
 class AbstractAction
          此类提供 JFC Action 接口的默认实现。
 

返回 Actionjavax.swing 中的方法
 Action ActionMap.get(Object key)
          返回 key 的绑定,如果该绑定不是本地定义的,则将此消息传递给父 ActionMap
 Action JTextField.getAction()
          返回此 ActionEvent 源当前设置的 Action,如果没有设置 Action 则返回 null
 Action JComboBox.getAction()
          返回此 ActionEvent 源当前设置的 Action,如果没有设置任何 Action,则返回 null
 Action AbstractButton.getAction()
          返回当前为此 ActionEvent 源设置的 Action,如果没有设置任何 Action,则返回 null
 Action[] JFormattedTextField.getActions()
          获取编辑器的命令列表。
protected  Action[] JFormattedTextField.AbstractFormatter.getActions()
          如果想提供自定义的 Action 集合,则应进行子类化和重写。
 Action[] JTextField.getActions()
          获取编辑器的命令列表。
static Action TransferHandler.getCopyAction()
          返回一个执行复制到剪贴板操作的 Action
static Action TransferHandler.getCutAction()
          返回一个执行剪切到剪贴板操作的 Action
static Action TransferHandler.getPasteAction()
          返回一个从剪贴板执行粘贴操作的 Action
 

参数类型为 Actionjavax.swing 中的方法
protected  void JTextField.actionPropertyChanged(Action action, String propertyName)
          更新文本字段的状态以响应关联动作中的属性更改。
protected  void JComboBox.actionPropertyChanged(Action action, String propertyName)
          更新组合框的状态以响应关联动作中的属性更改。
protected  void JMenuItem.actionPropertyChanged(Action action, String propertyName)
          更新按钮的状态以响应相关的操作中的属性更改。
protected  void AbstractButton.actionPropertyChanged(Action action, String propertyName)
          更新按钮的状态以响应相关的操作中的属性更改。
 JMenuItem JPopupMenu.add(Action a)
          将指派指定 Action 对象的新菜单项添加到菜单的末尾。
 JButton JToolBar.add(Action a)
          添加一个指派动作的新的 JButton
 JMenuItem JMenu.add(Action a)
          创建连接到指定 Action 对象的新菜单项,并将其追加到此菜单的末尾。
protected  void JTextField.configurePropertiesFromAction(Action a)
          在此文本字段上设置属性,以匹配指定 Action 中的值。
protected  void JComboBox.configurePropertiesFromAction(Action a)
          在此组合框上设置属性以匹配指定 Action 中的属性。
protected  void JMenuItem.configurePropertiesFromAction(Action a)
          在此按钮上设置属性以匹配指定 Action 中的属性。
protected  void AbstractButton.configurePropertiesFromAction(Action a)
          在此按钮上设置属性以匹配指定 Action 中的属性。
protected  JMenuItem JPopupMenu.createActionComponent(Action a)
          该工厂方法为添加到 JPopupMenuAction 创建对应的 JMenuItem
protected  JButton JToolBar.createActionComponent(Action a)
          将为 Action 创建 JButton 的工厂方法添加到 JToolBar 中。
protected  JMenuItem JMenu.createActionComponent(Action a)
          该工厂方法创建添加到 JMenuActionJMenuItem
protected  PropertyChangeListener JTextField.createActionPropertyChangeListener(Action a)
          创建并返回一个负责侦听指定 Action 的更改以及更新适当属性的 PropertyChangeListener
protected  PropertyChangeListener JComboBox.createActionPropertyChangeListener(Action a)
          创建并返回一个 PropertyChangeListener,它负责侦听指定 Action 的更改并更新适当属性。
protected  PropertyChangeListener AbstractButton.createActionPropertyChangeListener(Action a)
          创建并返回 PropertyChangeListener,它负责侦听指定 Action 的更改以及更新适当的属性。
 void JPopupMenu.insert(Action a, int index)
          在给定位置插入指定 Action 对象的菜单项。
 JMenuItem JMenu.insert(Action a, int pos)
          在给定位置插入连接到指定 Action 对象的新菜单项。
static boolean SwingUtilities.notifyAction(Action action, KeyStroke ks, KeyEvent event, Object sender, int modifiers)
          如果启用 action(且为非 null),则调用 action 上的 actionPerformed
 void ActionMap.put(Object key, Action action)
          添加一个 keyaction 的绑定。
 void JTextField.setAction(Action a)
          设置 ActionEvent 源的 Action
 void JComboBox.setAction(Action a)
          设置 ActionEvent 源的 Action
 void AbstractButton.setAction(Action a)
          设置 Action
 

参数类型为 Actionjavax.swing 中的构造方法
JButton(Action a)
          创建一个按钮,其属性从所提供的 Action 中获取。
JCheckBox(Action a)
          创建一个复选框,其属性从所提供的 Action 获取。
JCheckBoxMenuItem(Action a)
          创建一个从所提供的 Action 中获取其属性的菜单项。
JMenu(Action a)
          构造一个从提供的 Action 获取其属性的菜单。
JMenuItem(Action a)
          创建从指定的 Action 获取其属性的菜单项。
JRadioButton(Action a)
          创建一个单选按钮,其属性来自提供的 Action。
JRadioButtonMenuItem(Action a)
          创建一个单选按钮菜单项,其属性来自提供的 Action
JToggleButton(Action a)
          创建一个切换按钮,其属性从所提供的 Action 获取。
 

javax.swing.plaf.basicAction 的使用
 

实现 Actionjavax.swing.plaf.basic 中的类
protected  class BasicDesktopPaneUI.CloseAction
          处理关闭一个内部窗体。
protected  class BasicDesktopPaneUI.MaximizeAction
          处理最大化一个内部窗体。
protected  class BasicDesktopPaneUI.MinimizeAction
          处理最小化一个内部窗体。
protected  class BasicDesktopPaneUI.NavigateAction
          处理导航到下一个内部窗体。
protected  class BasicDesktopPaneUI.OpenAction
          处理恢复一个最小化或最大化的内部窗体。
protected  class BasicFileChooserUI.ApproveSelectionAction
          响应 Open 或 Save 请求
protected  class BasicFileChooserUI.CancelSelectionAction
          响应取消请求。
protected  class BasicFileChooserUI.ChangeToParentDirectoryAction
           
protected  class BasicFileChooserUI.GoHomeAction
          基于“Home”键事件或等效事件的动作。
protected  class BasicFileChooserUI.NewFolderAction
          创建新文件夹。
protected  class BasicFileChooserUI.UpdateAction
          重新扫描当前目录中的文件。
 class BasicInternalFrameTitlePane.CloseAction
          此类应视为“受保护”内部类。
 class BasicInternalFrameTitlePane.IconifyAction
          此类应视为“受保护”内部类。
 class BasicInternalFrameTitlePane.MaximizeAction
          此类应视为“受保护”内部类。
 class BasicInternalFrameTitlePane.MoveAction
          此类应视为“受保护”内部类。
 class BasicInternalFrameTitlePane.RestoreAction
          此类应视为“受保护”内部类。
 class BasicInternalFrameTitlePane.SizeAction
          此类应视为“受保护”内部类。
 class BasicSliderUI.ActionScroller
          从 Java 2 平台 v1.3 开始,不再使用这种以前没有记录的类。
 class BasicTreeUI.TreeCancelEditingAction
          执行操作时调用 cancelEditing 的 ActionListener。
 class BasicTreeUI.TreeHomeAction
          TreeHomeAction 用于处理 end/home 动作。
 class BasicTreeUI.TreeIncrementAction
          TreeIncrementAction 用于处理向上/向下操作。
 class BasicTreeUI.TreePageAction
          TreePageAction 处理向上翻页和向下翻页事件。
 class BasicTreeUI.TreeToggleAction
          对于第一个选定行展开将被切换。
 class BasicTreeUI.TreeTraverseAction
          TreeTraverseAction 是用于向左/向右方向键的动作。
 

声明为 Actionjavax.swing.plaf.basic 中的字段
protected  Action BasicInternalFrameTitlePane.closeAction
           
protected  Action BasicInternalFrameTitlePane.iconifyAction
           
protected  Action BasicInternalFrameTitlePane.maximizeAction
           
protected  Action BasicInternalFrameTitlePane.moveAction
           
protected  Action BasicTreeUI.KeyHandler.repeatKeyAction
          正在生成的键代码。
protected  Action BasicInternalFrameTitlePane.restoreAction
           
protected  Action BasicInternalFrameTitlePane.sizeAction
           
 

返回 Actionjavax.swing.plaf.basic 中的方法
protected  Action BasicLookAndFeel.createAudioAction(Object key)
          创建并返回用于播放音频的 Action
 Action BasicFileChooserUI.getApproveSelectionAction()
           
 Action BasicFileChooserUI.getCancelSelectionAction()
           
 Action BasicFileChooserUI.getChangeToParentDirectoryAction()
           
 Action BasicFileChooserUI.getGoHomeAction()
           
 Action BasicFileChooserUI.getNewFolderAction()
           
 Action BasicFileChooserUI.getUpdateAction()
           
 

参数类型为 Actionjavax.swing.plaf.basic 中的方法
protected  void BasicLookAndFeel.playSound(Action audioAction)
          如有必要,在 audioAction 上调用 actionPerformed 以播放声音。
 

javax.swing.plaf.metalAction 的使用
 

实现 Actionjavax.swing.plaf.metal 中的类
protected  class MetalFileChooserUI.DirectoryComboBoxAction
          当 DirectoryComboBox 已更改所选项时调用。
 

javax.swing.textAction 的使用
 

实现 Actionjavax.swing.text 中的类
static class DefaultEditorKit.BeepAction
          创建蜂鸣声。
static class DefaultEditorKit.CopyAction
          复制选定的区域并将其内容放入系统剪贴板中。
static class DefaultEditorKit.CutAction
          剪切选定的区域并将其内容放入系统剪贴板中。
static class DefaultEditorKit.DefaultKeyTypedAction
          如果接收到键输入事件 并且无 keymap 输入,则默认执行该动作。
static class DefaultEditorKit.InsertBreakAction
          在文档中放置行/段落中断。
static class DefaultEditorKit.InsertContentAction
          将内容置于关联的文档中。
static class DefaultEditorKit.InsertTabAction
          将一个制表符置于文档中。
static class DefaultEditorKit.PasteAction
          将系统剪贴板内容粘贴到选定区域,如果未选中任何内容,则粘贴到插入符前面。
static class StyledEditorKit.AlignmentAction
          设置段落对齐的操作。
static class StyledEditorKit.BoldAction
          切换粗体属性的操作。
static class StyledEditorKit.FontFamilyAction
          在相关的 JEditorPane 中设置字体系列的操作。
static class StyledEditorKit.FontSizeAction
          设置关联的 JEditorPane 中字体大小的操作。
static class StyledEditorKit.ForegroundAction
          设置前景色的操作。
static class StyledEditorKit.ItalicAction
          切换斜体属性的一种操作。
static class StyledEditorKit.StyledTextAction
          假定是在安装有 StyledEditorKit(或者子类)的 JEditorPane 上触发的操作。
static class StyledEditorKit.UnderlineAction
          切换下划线属性的操作。
 class TextAction
          用于跨多个不同文本组件共享的键绑定的 Action 实现。
 

返回 Actionjavax.swing.text 中的方法
static Action[] TextAction.augmentList(Action[] list1, Action[] list2)
          取一个命令列表并用另一个命令列表去扩充。
 Action Keymap.getAction(KeyStroke key)
          获取适合于给定符号事件序列的操作。
protected  Action[] InternationalFormatter.getActions()
          如果 getSupportsIncrement 返回 true,则这将返回两个适合增加/减少该值的 Action。
 Action[] StyledEditorKit.getActions()
          获取编辑器的命令列表。
 Action[] DefaultEditorKit.getActions()
          获取能在文本组件上使用的一组命令,该文本组件使用由此工具包生成的模型和视图。
abstract  Action[] EditorKit.getActions()
          获取能在文本组件上使用的一组命令,该文本组件使用由此工具包生成的模型和视图。
 Action[] JTextComponent.getActions()
          获取编辑器的命令列表。
 Action[] Keymap.getBoundActions()
          获取在此 keymap 中定义的所有操作。
 Action Keymap.getDefaultAction()
          当击键(即接收 KEY_TYPED KeyEvent)且该键没有绑定操作的情况下获取激发的默认操作。
 

参数类型为 Actionjavax.swing.text 中的方法
 void Keymap.addActionForKeyStroke(KeyStroke key, Action a)
          向 keymap 添加绑定。
static Action[] TextAction.augmentList(Action[] list1, Action[] list2)
          取一个命令列表并用另一个命令列表去扩充。
static Action[] TextAction.augmentList(Action[] list1, Action[] list2)
          取一个命令列表并用另一个命令列表去扩充。
 KeyStroke[] Keymap.getKeyStrokesForAction(Action a)
          获取将导致给定操作的击键。
static void JTextComponent.loadKeymap(Keymap map, JTextComponent.KeyBinding[] bindings, Action[] actions)
           加载带有一组绑定的 keymap。
 void Keymap.setDefaultAction(Action a)
          在进行击键的情况下设置要激发的默认操作。
 

javax.swing.text.htmlAction 的使用
 

实现 Actionjavax.swing.text.html 中的类
static class HTMLEditorKit.HTMLTextAction
          提供某些便捷方法的抽象 Action,这些便捷方法对于将 HTML 插入现有文档可能很有用。
static class HTMLEditorKit.InsertHTMLTextAction
          InsertHTMLTextAction 可用于将任意 HTML 字符串插入现有 HTML 文档。
 

返回 Actionjavax.swing.text.html 中的方法
 Action[] HTMLEditorKit.getActions()
          获取编辑器的命令列表。
 


JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策