Qt键盘事件（一）——检测按键输入

引言

本节Jungle实现一个简单的功能：键盘按下某个键，Qt界面上显示出Jungle按下的是哪个键。

01

环境

Microsoft Visual Studio 2008 + Qt4.8.6

02

UI

03

Qt按键事件—QKeyEvent

QKeyEvent是一个描述Qt键盘事件的类。当有按键按下或者松开的时候，按键事件key event将会发送消息给QWidget。Key Event包含一个特殊的接收标记，标记接收者是否处理该按键事件。由于Jungle想标记按下的是哪个键，因此需要重载按键事件处理函数keyPressEvent。

另一方面，键盘上的每个键，都作为Qt的一个枚举成员，如下图（来源：Qt官方文档）

因此，可以在按键事件处理函数keyPressEvent中识别并在界面上打印出具体的按键。

04

实现

建立一个QKeyBoard的Qt Widget工程，在头文件中声明两个函数：

void keyPressEvent(QKeyEvent *event);
void keyReleaseEvent(QKeyEvent *event);

复制

源文件中实现如下：

void QKeyBoard::keyPressEvent(QKeyEvent *event){
  switch(event->key()){
    case Qt::Key_Escape:
      this->ui.textEdit_press->append("Key_Escape Press");
      break;
    case Qt::Key_Tab:
      this->ui.textEdit_press->append("Key_Tab Press");
      break;
    case Qt::Key_Enter:
      this->ui.textEdit_press->append("Key_Enter Press");
      break;
    case Qt::Key_Delete:
      this->ui.textEdit_press->append("Key_Delete Press");
      break;
    case Qt::Key_Space:
      this->ui.textEdit_press->append("Key_Space Press");
      break;
    case Qt::Key_Left:
      this->ui.textEdit_press->append("Key_Left Press");
      break;
    case Qt::Key_Up:
      this->ui.textEdit_press->append("Key_Up Press");
      break;
    case Qt::Key_Right:
      this->ui.textEdit_press->append("Key_Right Press");
      break;
    case Qt::Key_Down:
      this->ui.textEdit_press->append("Key_Down Press");
      break;
    /*default:
      this->ui.textEdit->append("KeyEvent");*/
  }
}
 
void QKeyBoard::keyReleaseEvent(QKeyEvent *event){
  switch(event->key()){
    case Qt::Key_Escape:
      this->ui.textEdit_release->append("Key_Escape Release");
      break;
    case Qt::Key_Tab:
      this->ui.textEdit_release->append("Key_Tab Release");
      break;
    case Qt::Key_Enter:
      this->ui.textEdit_release->append("Key_Enter Release");
      break;
    case Qt::Key_Delete:
      this->ui.textEdit_release->append("Key_Delete Release");
      break;
    case Qt::Key_Space:
      this->ui.textEdit_release->append("Key_Space Release");
      break;
    case Qt::Key_Left:
      this->ui.textEdit_release->append("Key_Left Release");
      break;
    case Qt::Key_Up:
      this->ui.textEdit_release->append("Key_Up Release");
      break;
    case Qt::Key_Right:
      this->ui.textEdit_release->append("Key_Right Release");
      break;
    case Qt::Key_Down:
      this->ui.textEdit_release->append("Key_Down Release");
      break;
      /*default:
      this->ui.textEdit->append("KeyEvent");*/
  }
}

复制

我们只处理几个键（Esc、Tab、Del、Enter、Space和4个方向键，其余键类似）。

05

问题：无法响应方向键按下事件？

调试过程中发现，其余键按下后界面均能打印出对应按键，但方向键却没有反应？查阅Qt官方文档后发现：

文档描述，widget必须调用setFocusPolicy方法才能接收按键事件。Jungle继续查阅setFocusPolicy：

如上所述，对于widget，需要使能键盘foucs，才能处理键盘事件。要让当前的widget能够响应按键事件，可以通过调用函数setFocusPolicy或者在UI设计界面设置FocusPolicy。

06

效果