今天在改进自己的一个小工具的时候,发现自己并未清楚的理解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的常用场景
- 一种常见的场景是对功能键的使用,尤其是ENTER键。我们可能想在文本框中输入信息后,按下ENTER进行搜索。这时KEY_PRESSED和KEY_RELEASED都可以使用。
- 如果我们是想检测输入的文字,则建议使用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