QT实现键盘复用：单击、双击、长按

由于项目需求，需要实现基于键盘按键的复用，查了很多资料都不满足我的需求，其中Mango的吐槽一下Qt的按键消息响应对我启发很大，他阐述了关于按键长按的问题，我的测试结果和他有些出入，但总体思路是一样的，也欢迎大家指正。下面来说一下具体的实现过程。

键盘按键单击、双击

首先键盘按键的单击、双击实现，没错！就是用的QTimer，一说到这估计大部分人都知道怎么回事了，但这里也有个误区，那就是如何区分单击和双击的问题，这也是我实现过程中遇到的问题。我最开始的做法是根据按下和释放的时间间隔来区分的，现在看来这显然是不对的，但当时脑袋可能蒙圈了（>_<），这样是无法准确的区分单击和双击的，应该用两次按键的时间间隔来区分，这里在按下、或释放里实现都是可以的，我最后选择在释放里实现，后面再说原因。如果谁不清楚按下、释放什么意思，自己去查qt帮助文档吧。。。
头文件里定义几个相关变量

//MyClass.h    QTimer*                     timer_;    bool                        LongPress_;//后面用到    int                         ClickCount_;//按键计数    KeyFlag                     KeyFlag_;//枚举

enum KeyFlag{    kKey_NULL,    kKey_A,    kKey_S,    kKey_D,    kKey_F,    kKey_J,    kKey_K};

构造函数连接timeout信号到单击函数

//MyClass.cpp    timer_ = new QTimer(this);    connect(timer_, SIGNAL(timeout()), this, SLOT(KeyOneClick()));    ClickCount_ = 0;    LongPress_ = false;    KeyFlag_ = kKey_NULL;

重写void keyReleaseEvent(QKeyEvent *event)

void MyClass::keyReleaseEvent(QKeyEvent *event) {    switch (event->key())    {    case Qt::Key_A:        if (!timer_->isActive()) {//计数期间，如果QTimer已开始，则不重新开始            timer_->start(400);//400ms是判断双击的时间间隔，不唯一，可根据实际情况改变            KeyFlag_ = kKey_A;//单击函数的按键标识        }        ClickCount_++;//点击计数，在400ms内如果点击两次认为是双击        if (ClickCount_ == 2){            timer_->stop();//停止计时            ClickCount_ = 0;//计数清零            cout << "this is A double click" << endl;            DoDoubleThings();//执行按键A双击动作        }        break;    case Qt::Key_S://注意到没？我实现的都是字母键，其他键是不一样的        break;    case Qt::Key_D:        break;    case Qt::Key_F:        break;    case Qt::Key_J:        break;    case Qt::Key_K:        break;    default:        break;    }}

单击函数，在400ms内未达到双击次数，也就是未执行timer_->stop();时间耗尽触发timeout信号，执行单击动作。这里提一下stop()函数，QTimer执行start(n)后，如果不stop(),那它会循环执行。

void MyClass::KeyOneClick() {    switch (KeyFlag_)//判断点击的是哪个按键    {    case kKey_A:                ClickCount_ = 0;//计数清零        timer_->stop();//停止计时        cout << "this is A ckick" << endl;        DoSigalClickThings();//单击A的动作        break;    case kKey_S:        break;    case kKey_D:        break;    case kKey_F:        break;    case kKey_J:        break;    case kKey_K:        break;    default:        break;    }}

键盘按键长按

至此实现键盘单击和双击复用，那么我们再来看一下长按怎么处理呢？
先看一下按键长按的过程分析，我们知道一按一松实现一次click动作，那我们测试一下qt键盘长按的具体过程，重写void keyPressEvent(QKeyEvent *event)、void keyReleaseEvent(QKeyEvent *event)函数。

为了区分是否是长按，QKeyEvent 提供了一个isAutoRepeat()函数自动检测按键是否长按

• 长按返回true
• 非长按返回false

为了方便表示我定义

• P：press动作
• R：release动作
• T：isAutoRepeat()返回true
• F：isAutoRepeat()返回false

下面看一下长按会发生什么吧。

void MyClass::keyPressEvent(QKeyEvent *event) {    switch (event->key())    {    case Qt::Key_A:             if (!event->isAutoRepeat()) {            //非长按输出press、not repeat等关键词            cout << "this is A press: not Auto Repeat" << endl;        }        else{                   //长按输出press、is repeat等关键词               cout << "this is A press: is Auto Repeat" << endl;         }        break;    default:        break;    }}

void MyClass::keyReleaseEvent(QKeyEvent *event) {    switch (event->key())    {    case Qt::Key_A:             if (!event->isAutoRepeat()) {            //非长按输出release、not repeat等关键词            cout << "this is A release: not Auto Repeat" << endl;        }        else{                   //非长按输出release、is repeat等关键词            cout << "this is A release: is Auto Repeat" << endl;         }        break;    default:        break;    }}

运行结果用我的方式表示为：P(F)R(T)P(T)R(T)…P(T)R(T)P(T)R(F)，也就是当你长按时会循环发生press和release动作，

1. 第一次执行press动作，此时QKeyEvent 不认为你在长按，而在release时，QKeyEvent 已经开始认为你在长按了；
2. 第二次到倒数第二次QKeyEvent 认为你都在长按；
3. 最后一次，press动作依然为长按，但release却变成非长按了；

也就是不管你按多久最开始的press肯定为非长按状态，最后的release肯定为非长按状态。结合这些特性，我们来实现键盘按键的复用，即同时实现单击双击和长按三个动作。

前面提到单击和双击的区分，其实在void keyPressEvent(QKeyEvent *event)、void keyReleaseEvent(QKeyEvent *event)函数里都可以，反正都是记录时间差，press-press或release-release没分别，那最后为什么选择在keyReleaseEvent(QKeyEvent *event)函数里实现呢？

问题就在还得同时实现长按功能，刚刚分析得出无论你长按还是非长按，第一次的press动作他都是P(F)的，如果在void keyPressEvent(QKeyEvent *event)里实现，那长按必然会附加一次单击，这当然不是我们想要的；

再来看看在void keyReleaseEvent(QKeyEvent *event)，如果长按，它第一次就是R(T)了，那就可以通过判断isAutoRepeat()的状态来区分长按和非长按了。

还有一个问题就是，虽然可以判断长按了，但是长按时是会循环执行的，如不控制，岂不会执行n次长按要实现的动作，因此还要加一个flag来控制，让它只执行一次。

最后，还要讨论一下长按的最后一次release动作，它和非长按的release是相同的R(F)，为了避免这种情况，我们正好利用控制长按的flag来进行区分。

至此分析完毕，我想我们该开始写代码了。

void MyClass::keyReleaseEvent(QKeyEvent *event) {    switch (event->key())    {    case Qt::Key_A:        //是否是长按可以从release中直接判断        if (!event->isAutoRepeat()) {            //LongPress_初始值为false，如果非长按执行单击或双击动作判断            //如果长按会在长按里将其置true，在最后的R(F)里就不会执行单击、双击判断的动作            if (!LongPress_) {                if (!timer_->isActive()) {                    timer_->start(400);                    KeyFlag_ = kKey_A;                }                ClickCount_++;                if (ClickCount_ == 2){                    timer_->stop();                    ClickCount_ = 0;                    cout << "this is A doubleclick" << endl;                    DoDoubleThings();//执行按键A双击动作                }            }            LongPress_ = false;//置false        }        else{                       if (!LongPress_) {                 cout << "this is longpress" << endl;                 //限定长按只执行一次,最后会在R(F)里将LongPress_重新置false                LongPress_ = true;                DoLongPressThings();            }                   }        break;    case Qt::Key_S:        break;    case Qt::Key_D:        break;    case Qt::Key_F:        break;    case Qt::Key_J:        break;    case Qt::Key_K:        break;    default:        break;    }   }

亲测有效，如有不同方法，欢迎讨论，或是有更好的方法，也请不吝分享！