QT实现键盘复用：单击、双击、长按
转自：https://blog.csdn.net/qq_27450255/article/details/78780959
由于项目需求，需要实现基于键盘按键的复用，查了很多资料都不满足我的需求，其中Mango的吐槽一下Qt的按键消息响应对我启发很大，他阐述了关于按键长按的问题，我的测试结果和他有些出入，但总体思路是一样的，也欢迎大家指正。下面来说一下具体的实现过程。
键盘按键单击、双击
首先键盘按键的单击、双击实现，没错！就是用的QTimer，一说到这估计大部分人都知道怎么回事了，但这里也有个误区，那就是如何区分单击和双击的问题，这也是我实现过程中遇到的问题。我最开始的做法是根据按下和释放的时间间隔来区分的，现在看来这显然是不对的，但当时脑袋可能蒙圈了（>_<），这样是无法准确的区分单击和双击的，应该用两次按键的时间间隔来区分，这里在按下、或释放里实现都是可以的，我最后选择在释放里实现，后面再说原因。如果谁不清楚按下、释放什么意思，自己去查qt帮助文档吧。。。
头文件里定义几个相关变量
1 //MyClass.h 2 QTimer* timer_; 3 bool LongPress_;//后面用到 4 int ClickCount_;//按键计数 5 KeyFlag KeyFlag_;//枚举
1 enum KeyFlag 2 { 3 kKey_NULL, 4 kKey_A, 5 kKey_S, 6 kKey_D, 7 kKey_F, 8 kKey_J, 9 kKey_K 10 };
构造函数连接timeout信号到单击函数
1 //MyClass.cpp 2 timer_ = new QTimer(this); 3 connect(timer_, SIGNAL(timeout()), this, SLOT(KeyOneClick())); 4 ClickCount_ = 0; 5 LongPress_ = false; 6 KeyFlag_ = kKey_NULL;
重写void keyReleaseEvent(QKeyEvent *event)
1 void MyClass::keyReleaseEvent(QKeyEvent *event) { 2 switch (event->key()) 3 { 4 case Qt::Key_A: 5 if (!timer_->isActive()) {//计数期间，如果QTimer已开始，则不重新开始 6 timer_->start(400);//400ms是判断双击的时间间隔，不唯一，可根据实际情况改变 7 KeyFlag_ = kKey_A;//单击函数的按键标识 8 } 9 ClickCount_++;//点击计数，在400ms内如果点击两次认为是双击 10 if (ClickCount_ == 2){ 11 timer_->stop();//停止计时 12 ClickCount_ = 0;//计数清零 13 cout << "this is A double click" << endl; 14 DoDoubleThings();//执行按键A双击动作 15 } 16 break; 17 18 case Qt::Key_S://注意到没？我实现的都是字母键，其他键是不一样的 19 break; 20 case Qt::Key_D: 21 break; 22 case Qt::Key_F: 23 break; 24 case Qt::Key_J: 25 break; 26 case Qt::Key_K: 27 break; 28 default: 29 break; 30 } 31 32 }
单击函数，在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
下面看一下长按会发生什么吧。
1 void MyClass::keyPressEvent(QKeyEvent *event) { 2 switch (event->key()) 3 { 4 case Qt::Key_A: 5 if (!event->isAutoRepeat()) { 6 //非长按输出press、not repeat等关键词 7 cout << "this is A press: not Auto Repeat" << endl; 8 } 9 else{ 10 //长按输出press、is repeat等关键词 11 cout << "this is A press: is Auto Repeat" << endl; 12 } 13 break; 14 default: 15 break; 16 } 17 18 } 19 20 void MyClass::keyReleaseEvent(QKeyEvent *event) { 21 switch (event->key()) 22 { 23 case Qt::Key_A: 24 if (!event->isAutoRepeat()) { 25 //非长按输出release、not repeat等关键词 26 cout << "this is A release: not Auto Repeat" << endl; 27 } 28 else{ 29 //非长按输出release、is repeat等关键词 30 cout << "this is A release: is Auto Repeat" << endl; 31 } 32 break; 33 default: 34 break; 35 } 36 37 }
运行结果用我的方式表示为：P(F)R(T)P(T)R(T)…P(T)R(T)P(T)R(F)，也就是当你长按时会循环发生press和release动作，
- 第一次执行press动作，此时QKeyEvent 不认为你在长按，而在release时，QKeyEvent 已经开始认为你在长按了；
- 第二次到倒数第二次QKeyEvent 认为你都在长按；
- 最后一次，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来进行区分。
至此分析完毕，我想我们该开始写代码了。
1 void MyClass::keyReleaseEvent(QKeyEvent *event) { 2 switch (event->key()) 3 { 4 case Qt::Key_A: 5 //是否是长按可以从release中直接判断 6 if (!event->isAutoRepeat()) { 7 //LongPress_初始值为false，如果非长按执行单击或双击动作判断 8 //如果长按会在长按里将其置true，在最后的R(F)里就不会执行单击、双击判断的动作 9 if (!LongPress_) { 10 if (!timer_->isActive()) { 11 timer_->start(400); 12 KeyFlag_ = kKey_A; 13 } 14 ClickCount_++; 15 if (ClickCount_ == 2){ 16 timer_->stop(); 17 ClickCount_ = 0; 18 cout << "this is A doubleclick" << endl; 19 DoDoubleThings();//执行按键A双击动作 20 } 21 } 22 LongPress_ = false;//置false 23 } 24 else{ 25 if (!LongPress_) { 26 cout << "this is longpress" << endl; 27 //限定长按只执行一次,最后会在R(F)里将LongPress_重新置false 28 LongPress_ = true; 29 DoLongPressThings(); 30 } 31 } 32 break; 33 34 case Qt::Key_S: 35 break; 36 case Qt::Key_D: 37 break; 38 case Qt::Key_F: 39 break; 40 case Qt::Key_J: 41 break; 42 case Qt::Key_K: 43 break; 44 default: 45 break; 46 } 47 }
亲测有效，如有不同方法，欢迎讨论，或是有更好的方法，也请不吝分享！
