本文链接： https://blog.csdn.net/sinat_21107433/article/details/101848809

1.问题描述

在Jungle的上一篇文章中（Qt键盘事件（一）——检测按键输入及解决无法响应方向键问题），Jungle简单实现了利用qt检测用户按键操作并将键按下\释放操作打印在Qt界面上的一个小程序。但是在测试过程中会出现一个现象，那就是长按某个键不放，界面一直在刷新press、release、press、release……（如下图）

也就是说，在长按某个键不释放的情况下，keyPressEvent和keyReleaseEvent事件会不断被触发。尽管这是Qt设计实现好的事件机制，但在用户体验上，这是不合常理的。我们希望实现的是：按下某个键（比如Tab键），界面只打印一次"Key_Tab Press"；当手松开时，界面上才打印"Key_Tab Release"。

2.问题说明event->isAutoRepeat()

为此，Jungle查询了Qt官方文档和几篇博客。

官方文档上提到一个QKeyEvent的成员函数isAutoRepeat:

bool QKeyEvent::isAutoRepeat () const
Returns true if this event comes from an auto-repeating key; returns false if it comes from an initial key press.

Note that if the event is a multiple-key compressed event that is partly due to auto-repeat, this function could return either true or false indeterminately.

可以看到，当event来自于auto-repeating key，isAutoRepeat返回true；当event事件来自于最初的按键，则sAutoRepeat返回false。这么说可能不好理解，那不妨Jungle做个小测试。

2.1.在keyPressEvent里打印isAutoRepeat返回值

操作：长按Tab键，在keyPressEvent里打印isAutoRepeat返回值，松开Tab键后，再次长按Tab键，再松开

void QKeyBoard::keyPressEvent(QKeyEvent *event){
	switch(event->key()){
		case Qt::Key_Tab:
			if(event->isAutoRepeat()==true){
				this->ui.textEdit_press->append("true");
			}
			else{
				this->ui.textEdit_press->append("false");
			}
			this->ui.textEdit_press->append("Key_Tab Press");
			break;
		/*default:
			this->ui.textEdit->append("KeyEvent");*/
	}
}

测试结果如下图：

从测试结果可以看到，长按下Tab键第一次触发keyPressEvent事件时isAutoRepeat返回false，之后长按过程中isAutoRepeat返回值均为true。松键后再次长按，isAutoRepeat返回false，之后长按过程中isAutoRepeat返回值均为true。即只有首次按下Tab键时，isAutoRepeat返回值为false。结合这个结果来看Qt官方文档的描述，似乎更好理解一点。

2.2.在keyReleaseEvent里打印isAutoRepeat返回值

同样，Jungle在keyReleaseEvent里打印isAutoRepeat返回值，运行结果如下（代码略）：

可以看到， 长按下Tab键，自动触发keyReleaseEvent事件时isAutoRepeat返回true，真正松键后触发keyReleaseEvent事件时isAutoRepeat返回true。

2.3.测试总结

结合Qt官方文档和上述测试，可以得出如下结论：

按键触发的keyPressEvent事件，isAutoRepeat返回false；自动触发的keyPressEvent事件，isAutoRepeat返回true；
松键触发的keyReleaseEvent事件，isAutoRepeat返回true；自动触发的keyReleaseEvent事件，isAutoRepeat返回false。

3.解决

在真正按键和松键事件触发时，加上对isAutoRepeat返回值的判断，具体判断如2.3总结所言，示例代码如下：

void QKeyBoard::keyPressEvent(QKeyEvent *event){
	switch(event->key()){
		case Qt::Key_Tab:
			if(!event->isAutoRepeat()){
				this->ui.textEdit_press->append("Key_Tab Press");
                /* add your code here*/
			}
			break;
	
		/*default:
			this->ui.textEdit->append("KeyEvent");*/
	}
}

void QKeyBoard::keyReleaseEvent(QKeyEvent *event){
	switch(event->key()){
		case Qt::Key_Tab:
			if(!event->isAutoRepeat()){
				this->ui.textEdit_release->append("Key_Tab Release");
                /* add your code here*/
			}
			break;
		/*default:
			this->ui.textEdit->append("KeyEvent");*/
	}
}

在某些博客里，作者可能增设了某个变量来标记键是否被按下，并在按下和松键时更新标记。但Jungle认为并没有必要，像上述那样加入判断即可。

相关代码请访问Jungle的GitHub主页：https://github.com/FengJungle/Qt_Project

Qt键盘事件（二）——长按按键反复触发event事件问题解决