如何编写密钥侦听器

按键事件指示用户何时在键盘上键入。具体来说，当用户按下或释放键盘按键时，按键事件由具有键盘焦点的组件触发。有关焦点的详细信息，请参见如何使用 Focus 子系统。

发送有关两种基本键事件的通知：

• 键入 Unicode 字符

• 按下或释放键盘上的键

第一种事件称为“键类型”事件。第二种是按键或按键释放事件。

通常，除非您需要知道用户何时按下与字符不对应的键，否则您仅对键键入的事件做出反应。例如，要知道用户何时键入 Unicode 字符(无论是通过按“ a”之类的一个键还是依次按几个键)，就可以处理键类型的事件。另一方面，要知道用户何时按下 F1 键，或者用户是否按下数字键盘上的“ 3”键，则可以处理按键事件。

要使组件获得键盘焦点，请按照下列步骤操作：

• 确保组件的isFocusable方法返回true。此状态允许组件接收焦点。例如，可以通过调用标签上的setFocusable(true)方法为JLabel组件启用键盘焦点。

• 确保适当时组件请求焦点。对于自定义组件，请实现一个鼠标侦听器，该鼠标侦听器在单击该组件时会调用requestFocusInWindow方法。

component.setFocusTraversalKeysEnabled(false)

您可以获取有关特定按键事件的详细信息。例如，您可以查询按键事件，以确定是否从操作键中触发了该事件。操作键的示例包括复制，粘贴，向上翻页，撤消以及箭头键和功能键。您还可以查询按键或释放键的事件，以确定触发该事件的键的位置。大多数按键事件是从标准键盘触发的，但是某些按键的事件(例如 Shift)具有有关用户是否按下键盘左侧或右侧的 Shift 键的信息。同样，可以从标准键盘或数字键盘 Importing 数字“ 2”。

对于键类型的事件，您可以获得键字符值以及使用的所有修饰符。

下面的示例演示关键事件。它由一个您可以键入的文本字段组成，其后是一个文本区域，该文本区域在每次触发键事件时都会显示一条消息。窗口底部的按钮可让您同时清除文本字段和文本区域。

您可以在KeyEventDemo.java中找到示例的代码。这是演示的关键事件处理代码：

public class KeyEventDemo ...  implements KeyListener ... {
    ...//where initialization occurs:
        typingArea = new JTextField(20);
        typingArea.addKeyListener(this);

        //Uncomment this if you wish to turn off focus
        //traversal.  The focus subsystem consumes
        //focus traversal keys, such as Tab and Shift Tab.
        //If you uncomment the following line of code, this
        //disables focus traversal and the Tab events 
        //become available to the key event listener.
        //typingArea.setFocusTraversalKeysEnabled(false);
    ...
    /** Handle the key typed event from the text field. */
    public void keyTyped(KeyEvent e) {
        displayInfo(e, "KEY TYPED: ");
    }

    /** Handle the key-pressed event from the text field. */
    public void keyPressed(KeyEvent e) {
        displayInfo(e, "KEY PRESSED: ");
    }

    /** Handle the key-released event from the text field. */
    public void keyReleased(KeyEvent e) {
        displayInfo(e, "KEY RELEASED: ");
    }
    ...
    private void displayInfo(KeyEvent e, String keyStatus){
        
        //You should only rely on the key char if the event
        //is a key typed event.
        int id = e.getID();
        String keyString;
        if (id == KeyEvent.KEY_TYPED) {
            char c = e.getKeyChar();
            keyString = "key character = '" + c + "'";
        } else {
            int keyCode = e.getKeyCode();
            keyString = "key code = " + keyCode
                    + " ("
                    + KeyEvent.getKeyText(keyCode)
                    + ")";
        }
        
        int modifiersEx = e.getModifiersEx();
        String modString = "extended modifiers = " + modifiersEx;
        String tmpString = KeyEvent.getModifiersExText(modifiersEx);
        if (tmpString.length() > 0) {
            modString += " (" + tmpString + ")";
        } else {
            modString += " (no extended modifiers)";
        }
        
        String actionString = "action key? ";
        if (e.isActionKey()) {
            actionString += "YES";
        } else {
            actionString += "NO";
        }
        
        String locationString = "key location: ";
        int location = e.getKeyLocation();
        if (location == KeyEvent.KEY_LOCATION_STANDARD) {
            locationString += "standard";
        } else if (location == KeyEvent.KEY_LOCATION_LEFT) {
            locationString += "left";
        } else if (location == KeyEvent.KEY_LOCATION_RIGHT) {
            locationString += "right";
        } else if (location == KeyEvent.KEY_LOCATION_NUMPAD) {
            locationString += "numpad";
        } else { // (location == KeyEvent.KEY_LOCATION_UNKNOWN)
            locationString += "unknown";
        }
        
        ...//Display information about the KeyEvent...
    }
}

密钥侦听器 API

KeyListener interface

对应的适配器类为KeyAdapter.

KeyEvent 类

KeyEvent类继承了InputEvent类的许多有用方法，例如getModifiersEx，还继承了ComponentEvent和AWTEvent类的一些有用方法。有关完整列表，请参见mouse listener页中的InputEvent Class表。

使用键侦听器的示例

下表列出了使用键侦听器的示例。