Qt 6中的输入事件

Qt Quick中鼠标和触摸事件的传递非常复杂,几年前我们就清楚了我们需要重构事件继承层次结构,为各种事件类型提供一些通用的API,以便可以将更多传递代码共享。在Qt 5.8中,我们添加了QQuickPointerEvent和关联的类型,作为对可能的样子进行原型制作的一种方法。它们是QObjects。从那时起,QQuickWindow一直在交付这些包装器事件,这些包装器事件将原始事件承载在内部。现在终于在Qt 6中,我们已经能够完成QEvent重构,因此QQuickWindow不再需要包装器。除此之外,我们还能够添加一些功能并修复了一些错误。Qt 5中似乎很难解决的许多其他错误至少应在以后修复。

向QPointerEvent和QEventPoint问好

现在,继承层次结构如下所示:

事件层次结构qt6


QPointerEvent是来自指针设备(鼠标,触摸屏,平板电脑手写笔)的所有事件的新抽象类型。它具有通用API,能够以与设备无关的方式处理所有这些问题。由于QTouchEvent可以在一个事件中携带多个接触点,因此我们对这一概念进行了标准化:每个QPointerEvent都可能代表QEventPoint实例的集群(即使大多数事件仅携带一个点),因此具有适当的API:points(),point(i)和pointCount()。
每个QInputEvent(包括QPointerEvent)都带有指向它来自的QInputDevice的指针。即使处理合成鼠标事件,事件处理代码也可以以设备特定的方式响应。

每个QEventPoint都有速度。Qt Quick在Qt 5中使用的卡尔曼滤波器已移至QtGui,因此无论事件传递到何处,都可以使用最近几次移动的平均速度。这样,无论速度来自哪个设备,都可以实现对速度敏感的行为(例如,将快速拖动与快速拖动区别开来,或响应特定的运动方向)。对于这样的目的,瞬时速度通常太不稳定,但是如果需要,可以将其计算为(globalPosition() - globalLastPosition()) / (timestamp() - lastTimestamp())

QSinglePointEvent是另一种抽象类型,用于标准化位置访问器,该位置访问器以前在QMouseEvent,QTabletEvent,QHoverEvent,QWheelEvent等中单独实现且不一致。它们现在都是浮点数。position()替换pos()和posF(),scenePosition()替换windowPos(),而globalPosition()替换screenPos()。旧的访问器现在仍然存在,但是已被弃用:例如,仅由于处理QMouseEvent,Qt 5应用程序就不会遇到SC中断。QEventPoint代替了QTouchEvent :: TouchPoint,但是出于源兼容性的考虑,有一个“使用中”的声明。

我已经分手了,并添加了新的qevent-accessors检查,这可能为您省去一些麻烦:它可以自动应用“ fixits”来摆脱由于事件访问器重命名而引起的弃用警告。(是的,我们应该在这一变化的上游。)

C ++中与设备无关的事件处理

现在,在Qt的各个地方,我们可以通过迭代QEventPoints或仅响应第一点来响应鼠标,触摸和平板电脑事件(例如检测单击或拖动)。这是一个QQuickItem子类如何做到这一点的人为示例:

bool MyItem :: event(QEvent * ev)覆盖{
如果(ev-> isPointerEvent()){
QPointerEvent * pev = static_cast <QPointerEvent *>(ev);
for(QEventPoint&point:pev-> points()){
开关(point.state()){
case QEventPoint :: State :: Pressed:
if(reactToPress(point.position()))
pev-> setExclusiveGrabber(point,this );
打破;
case QEventPoint :: State :: Updated:
...
}
}
返回true;
}
return QQuickItem :: event(ev);
}

例如,QQuickFlickable :: childMouseEventFilter()以这种方式工作。这产生了一个有趣的结果:

可滑动的手柄现在触摸!

Qt 5的Flickable只能处理实际的鼠标事件和合成的鼠标事件,这涉及到许多开放的错误。Qt只支持一只鼠标,一个鼠标位置,一个光标(到目前为止,但是我们正在努力...),因此您无法用两根手指轻拂两个Flickable。如果您在Flickable中触摸了能够处理触摸事件的某个组件,但随后在允许的方向上在Flickable上拖动手指,则它将使用childMouseEventFilter()来窃取该组件的抓取;但是这涉及从实际触摸事件切换到合成鼠标事件,并且还记得将以下更新作为合成鼠标事件传递给Flickable。各种事情出了问题。好吧...那些日子已经过去了,因为Flickable :: childMouseEventFilter()不再关心QPointerEvents来自哪个设备。如果设置了pressDelay,则可以保留实际的触摸按键,然后在计时器到期时将其重播到其中的项目。是的,您现在也可以用多个手指拖动多个Flickable。

平行滑动


但是,多点触摸仍不能与其余的仅鼠标项(如MouseArea)一起使用,因为它们仍依赖于合成鼠标事件。但这是可以避免的。通常,请尝试使用事件处理程序而不是MouseArea,因为(顾名思义)它实际上不打算支持除鼠标交互以外的任何功能。

QTabletEvents(来自Wacom手写笔,Samsung S-pen,Apple Pencil等)也是具有更多属性的指针事件,并且可以由任何处理鼠标和触摸事件的与设备无关的代码来处理。但是,我们将继续努力改善这些体验。我们没有在QQuickItem中为其添加任何新的虚拟函数,但是它们很快就会被传递到QQuickItem :: event()。

我们仍在努力的另一件事是使Flickable在笔记本电脑触摸板上的性能更好。一个修复程序即将推出。

留给自己的设备

平台插件现在有责任发现和注册输入设备,以兑现每个QInputEvent告诉您确切来源的承诺。其中一些工作已经在某些平台上完成。(事实证明,这是有问题的。)您可以从QInputDevice :: devices()获取所有已注册设备的列表。qtdiag实用程序还会显示此列表。

QInputDevice是一个QObject,并且如果存在自然的层次结构,则它的parent()可以是另一个设备:例如,X11具有主设备和从设备,而数位板手写笔“属于”特定的数位板设备。在其他情况下,父对象只是平台插件中的一个对象,该对象拥有该设备以用于内存管理。

在未完成设备发现工作的平台上,QInputEvent :: device()永远不会为null,而可以是取自QInputDevice :: primaryKeyboard()或QPointingDevice :: primaryMouse()的通用实例。触摸屏设备是独一无二的。我们已经在Qt 5中做到了这一点。

QInputDevice :: seatName()对应于“座位”的Wayland概念:一个用户正在使用的一组设备。到目前为止,几乎没有多座位支持,但是随着时间的推移它将得到改善。如果配置多指针X服务器,则可以在不同设备上看到不同的席位名称,但是这些名称是根据xcb插件中的xinput ID自动生成的。在Wayway合成器(如Sway)上,可以给座椅任意命名;我们计划Qt最终将与之合作。

$ xinput list
虚拟核心指针id = 2 [主指针(3)]
虚拟核心XTEST指针id = 4 [从属指针(2)]
ZSA Technology Labs ErgoDox EZ鼠标id = 11 [从属指针(2)]
ZSA Technology Labs ErgoDox EZ用户控制id = 13 [从属指针(2)]
Logitech MX Master 2S id = 15 [从属指针(2)]
虚拟核心键盘id = 3 [主键盘(2)]
虚拟核心XTEST键盘id = 5 [从属键盘(3)
电源按钮id = 6 [从属键盘(3)]
电源按钮id = 7 [从属键盘(3)]
睡眠按钮id = 8 [从属键盘(3)]
UVC摄像机(046d:0992)id = 9 [从属键盘(3)]
ZSA Technology Labs ErgoDox EZ id = 10 [从属键盘(3)]
ZSA Technology Labs ErgoDox EZ系统控件id = 12 [从属键盘(3)]
ZSA Technology Labs ErgoDox EZ键盘id = 14 [从属键盘(3)]
ZSA Technology Labs ErgoDox EZ Consumer Control id = 16 [从属键盘(3)]
Logitech MX Master 2S id = 17 [从属键盘(3)]
辅助指针id = 22 [主指针(23)]
Microsoft Microsoft光学鼠标,由Starck id = 19 [从属指针(22)]
辅助XTEST指针id = 24 [从属指针(22)]
辅助键盘id = 23 [主键盘(22)]
Apple,Inc.苹果键盘id = 20 [从属键盘(23)]
苹果公司Inc.苹果键盘id = 21 [从属键盘(23)]
aux XTEST键盘id = 25 [从属键盘(23)]

$ qtdiag
在“ xcb”
操作系统上的Qt 6.0.0(x86_64-little_endian-lp64共享(动态)调试版本;由GCC 10.2.0构建):Arch Linux [linux版本5.9.11-arch2-1]
...
输入设备:23
QInputDevice :: DeviceType :: Mouse“虚拟核心指针”,座位:“ 30002”功能:位置滚动悬停
QInputDevice :: DeviceType :: Keyboard“虚拟核心键盘”,座位:“ 30002”功能:
QInputDevice :: DeviceType :: Mouse“辅助指针”,座:“ 170016”功能:位置滚动悬停
QInputDevice :: DeviceType :: Keyboard“辅助键盘”,座:“ 170016”功能:
QInputDevice :: DeviceType :: Mouse“虚拟核心XTEST指针”,座: 30002“功能:位置滚动悬停
QInputDevice :: DeviceType :: Keyboard“虚拟核心XTEST键盘”,座位:“ 30002”功能:
QInputDevice :: DeviceType ::键盘“电源按钮”,座位:“ 30002”功能:
QInputDevice :: DeviceType ::键盘“电源按钮”,座位:“ 30002”功能:
QInputDevice :: DeviceType ::键盘“睡眠按钮”,席位:“ 30002”功能:
QInputDevice :: DeviceType ::键盘“ UVC摄像头(046d:0992)”,席位:“ 30002”功能:
QInputDevice :: DeviceType ::键盘“ ZSA Technology Labs ErgoDox EZ”,席位:“ 30002功能:
QInputDevice :: DeviceType :: Mouse“ ZSA Technology Labs ErgoDox EZ鼠标”,座椅:“ 30002”功能:位置滚动悬停
QInputDevice :: DeviceType :: Keyboard“ ZSA Technology Labs ErgoDox EZ System Control”,座椅:“ 30002 ”功能:
QInputDevice :: DeviceType :: Mouse“ ZSA Technology Labs ErgoDox EZ消费者控制”,座位:“ 30002”功能:位置滚动悬停
QInputDevice :: DeviceType :: Keyboard“ ZSA Technology Labs ErgoDox EZ键盘”,座位:“ 30002”功能:
QInputDevice :: DeviceType ::键盘“ ZSA Technology Labs ErgoDox EZ消费者控制”,位置:“ 30002”功能:
QInputDevice :: DeviceType ::鼠标“ Logitech MX Master 2S”,位置:“ 30002”功能:位置滚动悬停
QInputDevice: :设备类型::键盘“ Logitech MX Master 2S”,位置:“ 30002”功能:
QInputDevice ::设备类型::鼠标“ Starck的Microsoft Microsoft光学鼠标”,位置:“ 170016”功能:位置滚动悬停
QInputDevice :: DeviceType :: Keyboard“ Apple,Inc苹果键盘”,座位:“ 170016”功能:
QInputDevice :: DeviceType ::键盘“ Apple,Inc苹果键盘”,座:“ 170016”功能:
QInputDevice :: DeviceType ::鼠标“ aux XTEST指针”,座:“ 170016”功能:位置滚动悬停
QInputDevice :: DeviceType: :键盘“ aux XTEST键盘”,座位:“ 170016”功能:

QInputDevice :: availableVirtualGeometry()旨在告诉您该设备可以访问虚拟桌面的哪个区域。例如,您可能正在使用带有外部显示器的触摸屏笔记本电脑:那么触摸屏的QPointingDevice :: availableVirtualGeometry()应该与屏幕的QScreen :: geometry()相同。Wacom数位板可以映射到小于整个屏幕的区域,以提高绘图精度(使用xinput或特定于操作系统的控制面板)。但是同样,这项工作尚未在所有受支持的平台上完成。

合成鼠标事件

合成鼠标事件仍然存在,即使我们现在尝试减少对它们的依赖。

QEvent :: spontaneous()是我们必须区分OS生成的事件和合成事件的最古老的方法,但是它不适用于区分合成鼠标事件。在Qt 5中,添加了QMouseEvent :: source()来帮助您区分由其他设备,操作系统,Qt或应用程序与其他设备合成的鼠标事件。但随后我们发现,假设此类事件是从接触点合成的,这既诱人又是错误的。(例如,它可以从QTabletEvent合成。)因此,我们建议现在使用event->device()->type()和/或pointerDevice()->pointerType()区分它们。当QMouseEvent由其他类型的事件合成时,设备实例保持不变,因此您可以知道它的真正来源。

分类日志

自从几年前添加分类日志记录以来,我们一直在Qt中添加越来越多的内部日志记录。git grep Q_LOGGING_CATEGORY在qtbase和qtdeclarative中将找到许多用于调试Qt Quick应用程序的有用的工具。)解决鼠标和触摸交互问题的最有用的类别是qt.pointer.grab,因为抓取转换是这些问题的征兆或原因。但是还有更多:在交付项目和/或处理程序期间,您可以在QPA级别,QtGui级别,QQuickWindow中记录事件。您可以在各种项目和处理程序中记录交互的各个方面。

我可能会在以后的文章中写有关捕获和接受事件的更多技术细节。

祝您好运,并与Qt 6玩得开心!

https://www.qt.io/blog/input-events-in-qt-6

原文地址:https://www.cnblogs.com/findumars/p/14097494.html