Qml中的那些坑(三)---KeyEvent 的 key / virtualKey / scanCode

小鱼儿 2023-06-15 07:08 14阅读 0赞

### **【写在前面】** ###

在 Qt 中，对于一个键盘事件 QKeyEvent ，通常包含三种键值：

1、**key：Qt 键值，例如 Qt::Key\_Escape。**

2、**nativeVirtualKey：本机虚拟键值，例如 VK\_ESCAPE ( windows )。**

3、**nativeScanCode：本机扫描码。**

--------------------

###  **【正文开始】** ###

在 Qml 中，也存在着键盘事件：KeyEvent。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTEyODMyMjY_size_16_color_FFFFFF_t_70][]

看起来它与 QKeyEvent 没有什么太大的区别，然而实际上，它缺少 **nativeVirtualK****ey****。**

当然，很多时候我们仅仅使用它的 key 足矣，但是一个坑是 **Qt 键值****并没有包含所有的按键。**

来看下面代码：

void MyWindow::keyPressEvent(QKeyEvent *ev)
    {
        qDebug().noquote() << "按键:" << ev->text() << hex
                           << "key:" << ev->key()
                           << "nativeScanCode:" << ev->nativeScanCode()
                           << "nativeVirtualKey:" << ev->nativeVirtualKey();
    }

输出如下：

![20191222154543137.png][]

两个都是按键1，但第一个是数字键1，第二个却是小键盘的数字键1。

而它们的区别有两个，nativeScanCode 和 nativeVirtualKey。

事实上，当一个按键按下的时候，会发生以下转换：

![20191222155809942.png][]

前面提到了**Qt 键值****并没有包含所有的按键**，因此可以想到，在 virtualKey 转换的时候，两个不同的按键1都被转换( 映射 )成了Qt::Key\_1。

当然，如果仅仅是这样就算了，我们完全可以使用 nativeVirtualKey 来区分( 在C++中 )，然鹅在 Qml 中，恰好就没有nativeVirtualKey，这™就很尴尬了好吗。

由于某些应用的特殊性( 例如：远程控制 )，因此我必须知道，到底是哪个按键按下了。

能想到的解决方法有两个：

1、不使用 Qml 的 KeyEvent，而是使用 keyPressEvent(QKeyEvent \*event) 提供的 QKeyEvent::nativeVirtual 来区分。

2、使用 Qml 的 KeyEvent，但需要进行额外的判断，对于这种方法，由于所有的按键都有其 scanCode，所以我们最后还是可以通过 scanCode 来区分不同的按键。

--------------------

### **【结语】** ###

最后讲一下题外话。

因为我做的是远程控制，所以仅仅是区分不同的按键远远不够。

例如 Windows API 的 SendInput 或 keybd\_event( 被 SendInput 取代) 模拟按键事件时，就需要 virtualKey 值，也就是说最终还是得把 Qt Key 转换成 virtualKey。

所以在使用第二种方法的时候，仍然要进行转换，这里给一个KDE的工具(但是不完整而且仍不能区分所有键，所以我自己用的改进了一下)：[https://api.kde.org/frameworks/kwindowsystem/html/platforms\_2windows\_2kkeyserver\_8cpp\_source.html][https_api.kde.org_frameworks_kwindowsystem_html_platforms_2windows_2kkeyserver_8cpp_source.html]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTEyODMyMjY_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20191222161947872.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTEyODMyMjY=,size_16,color_FFFFFF,t_70
[20191222154543137.png]: https://img-blog.csdnimg.cn/20191222154543137.png
[20191222155809942.png]: https://img-blog.csdnimg.cn/20191222155809942.png
[https_api.kde.org_frameworks_kwindowsystem_html_platforms_2windows_2kkeyserver_8cpp_source.html]: https://api.kde.org/frameworks/kwindowsystem/html/platforms_2windows_2kkeyserver_8cpp_source.html