详细解析JavaFX的键盘事件KeyEvent - Pressd/Released/Typed

今天在改进自己的一个小工具的时候，发现自己并未清楚的理解JavaFX中键盘事件KeyEvent的用法。于是，我就阅读了一下文档，并进行了一些测试和分析。

KeyEvent有三种

我们应该已经知道，JavaFX中的KeyEvent有三种：

KeyEvent.KEY_PRESSED：任意按键按下时响应

KeyEvent.KEY_RELEASED：任意按键松开时响应

KeyEvent.KEY_TYPED：文字输入键按下松开后响应

【注意】这里需要注意到这三种事件的区别，尤其是KEY_TYPED只会响应文字输入键，如字母、数字和标点符号等，它不会响应CTRL/ENTER/F1等功能键。所以可以把这三种事件看作两大类。

对这三种事件的处理器设置分别对应为：

Node.setOnKeyPressed(EventHandler<? super KeyEvent> value)

Node.setOnKeyReleased(EventHandler<? super KeyEvent> value)

Node.setOnKeyTyped(EventHandler<? super KeyEvent> value)

KeyEvent的常用场景

1. 一种常见的场景是对功能键的使用，尤其是ENTER键。我们可能想在文本框中输入信息后，按下ENTER进行搜索。这时KEY_PRESSED和KEY_RELEASED都可以使用。
2. 如果我们是想检测输入的文字，则建议使用KEY_TYPED。比如，当你按下A键，你会得到小写字母a；但你按下SHIFT的同时按下A得到的是大写字母A。KEY_TYPED事件就是为此而生，他能够获取到最终输入的字符内容。而KEY_PRESSED和KEY_RELEASED只能知道你按下了什么键，而不知道最后输入的结果。当然，我们可以在KEY_TYPED中通过event.isShiftDown()来得知输入过程是否按下了SHIFT键。

KeyEvent获取按键的信息

针对这两种使用场景的不同，我们就可以理解两大类事件在获取按键信息时的不同处理方式。

KEY_PRESSED和KEY_RELEASED

在KEY_PRESSED和KEY_RELEASED事件中，你可以通过event.getCode()和event.getText()方法来获取按键的信息。一般我们会使用event.getCode()取到KeyCode，然后进行比对。你可以在KeyCode类中找到对键盘上每个按钮的唯一的定义，比如按键A的定义就是KeyCode.A。

tf.setOnKeyPressed(new EventHandler<KeyEvent>() {

    @Override
    public void handle(KeyEvent event) {
        if(event.getCode() == KeyCode.A){
            // do something
        }
    }
});

KEY_TYPED

在KEY_TYPED事件中，根据我们之前的分析(想想组合按键)，你无法获得你所按下的按键信息，你能得到的只有输入之后的文字。你可以通过event.getCharacter()方法得到。

tf.setOnKeyTyped(new EventHandler<KeyEvent>() {

    @Override
    public void handle(KeyEvent event) {
        System.out.println(event.getCharacter());
    }
});

 三种事件的执行顺序

对于一个文字输入键，你从按下到松开过程三个事件响应顺序如下：KEY_PRESSED、KEY_TYPED、KEY_RELEASED。不过我想这种使用场景很少，大体清楚就行。

最终样例

package me.alanz.keyeventdemo;

import javafx.application.Application;
import javafx.event.EventHandler;
import javafx.scene.Scene;
import javafx.scene.control.TextField;
import javafx.scene.input.KeyCode;
import javafx.scene.input.KeyEvent;
import javafx.stage.Stage;

/**
 *
 * @author Alan
 */
public class KeyEventDemo extends Application {

    @Override
    public void start(Stage primaryStage) {
        TextField tf = new TextField();
        tf.setOnKeyTyped(new EventHandler<KeyEvent>() {

            @Override
            public void handle(KeyEvent event) {
                System.out.println("setOnKeyTyped=");
                System.out.println("    event.isShiftDown()=" + event.isShiftDown());
                System.out.println("    event.getCharacter()=" + event.getCharacter());
                System.out.println("    event.getText()=" + event.getText());
                System.out.println("    event.getCode()=" + event.getCode());
            }
        });
        tf.setOnKeyPressed(new EventHandler<KeyEvent>() {

            @Override
            public void handle(KeyEvent event) {
                System.out.println("setOnKeyPressed=");
                if (event.getCode() == KeyCode.A) {
                    System.out.println("    You pressed A!");
                }
                System.out.println("    event.getCharacter()=" + event.getCharacter());
                System.out.println("    event.getText()=" + event.getText());
                System.out.println("    event.getCode()=" + event.getCode());
            }
        });
        tf.setOnKeyReleased(new EventHandler<KeyEvent>() {

            @Override
            public void handle(KeyEvent event) {
                System.out.println("setOnKeyReleased=");
                System.out.println("    event.getCharacter()=" + event.getCharacter());
                System.out.println("    event.getText()=" + event.getText());
                System.out.println("    event.getCode()=" + event.getCode());
            }
        });

        Scene scene = new Scene(tf, 300, 250);

        primaryStage.setTitle("Hello World!");
        primaryStage.setScene(scene);
        primaryStage.show();
    }

    /**
     * @param args the command line arguments
     */
    public static void main(String[] args) {
        launch(args);
    }

}

运行起来后按下SHIFT+A，得到如下打印信息：

setOnKeyPressed=
    event.getCharacter()=
    event.getText()=
    event.getCode()=SHIFT
setOnKeyPressed=
    You pressed A!
    event.getCharacter()=
    event.getText()=a
    event.getCode()=A
setOnKeyTyped=
    event.isShiftDown()=true
    event.getCharacter()=A
    event.getText()=
    event.getCode()=UNDEFINED
setOnKeyReleased=
    event.getCharacter()=
    event.getText()=a
    event.getCode()=A
setOnKeyReleased=
    event.getCharacter()=
    event.getText()=
    event.getCode()=SHIFT

转载请注明出处: http://www.alanzeng.cn/2015/09/javafx-key-event/