JavaSwing中JButton注册键盘快捷方式的方法与实例

在Java Swing编程中，为用户界面组件如按钮（JButton）添加键盘快捷方式是一个常见的需求，这可以通过调用registerKeyboardAction()方法实现。该方法允许开发者将特定的动作与按键组合关联起来，从而提高应用程序的可用性和响应速度。本文不仅解释了registerKeyboardAction()方法的基本概念和参数，还提供了一些实际应用中的代码示例。

方法详解

registerKeyboardAction()方法属于javax.swing.AbstractButton类，因此所有继承自AbstractButton的类（如JButton）均可使用此方法。其签名如下：

public void registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)

其中，anAction参数指定了当触发快捷键时执行的动作；aCommand是动作的命令字符串；aKeyStroke定义了触发动作的键位组合；aCondition指定了该快捷键何时生效，例如当窗口处于焦点状态时。

代码示例

示例1：来自Doolin项目

public JButton add(Action swingAction) {
  String name = (String) swingAction.getValue(SwingAction.ID_KEY);
  JButton button = new JButton(swingAction);
  button.setName(name);
  add(button);
  if (StringUtils.isNotBlank(name)) {
    this.buttons.put(name, button);
    KeyStroke key = (KeyStroke) swingAction.getValue(Action.ACCELERATOR_KEY);
    if (key != null) {
      button.registerKeyboardAction(swingAction, key, JButton.WHEN_IN_FOCUSED_WINDOW);
    }
  }
  return button;
}

此示例展示了如何通过一个Action对象创建一个按钮，并为其注册一个键盘快捷键。

示例2：来自Fedora Commons项目

JButton okButton = new JButton(createAction);
okButton.registerKeyboardAction(createListener, KeyStroke.getKeyStroke(KeyEvent.VK_ENTER, 0), JComponent.WHEN_IN_FOCUSED_WINDOW);

这里演示了如何直接为一个按钮注册“回车”键作为快捷键。

示例3：来自SynaptixWidget项目

button.registerKeyboardAction(button.getActionForKeyStroke(KeyStroke.getKeyStroke(KeyEvent.VK_SPACE, 0, false)), KeyStroke.getKeyStroke(KeyEvent.VK_ENTER, 0, false), JComponent.WHEN_FOCUSED);
button.registerKeyboardAction(button.getActionForKeyStroke(KeyStroke.getKeyStroke(KeyEvent.VK_SPACE, 0, true)), KeyStroke.getKeyStroke(KeyEvent.VK_ENTER, 0, true), JComponent.WHEN_FOCUSED);

这个例子显示了如何根据不同的按键状态（按下或释放）注册两个不同的快捷键。

示例4：来自LitiEngine项目

cop.getModel().setMnemonic('C');
KeyStroke keyStroke = KeyStroke.getKeyStroke('C', Event.CTRL_MASK, false);
cop.registerKeyboardAction(copyAction, keyStroke, JComponent.WHEN_IN_FOCUSED_WINDOW);
paste.getModel().setMnemonic('V');
KeyStroke keyStrokePaste = KeyStroke.getKeyStroke('V', Event.CTRL_MASK, false);
paste.registerKeyboardAction(pasteAction, keyStrokePaste, JComponent.WHEN_IN_FOCUSED_WINDOW);
cut.getModel().setMnemonic('X');
KeyStroke keyStrokeCut = KeyStroke.getKeyStroke('X', Event.CTRL_MASK, false);
cut.registerKeyboardAction(cutAction, keyStrokeCut, JComponent.WHEN_IN_FOCUSED_WINDOW);

这段代码说明了如何为复制、粘贴和剪切操作分别设置快捷键。