PointerDevice QML 类型

QML 对 QPointingDevice 的等效。

导入语句	import QtQuick
实例化	QPointingDevice

所有成员列表，包括继承的成员

属性

buttonCount : int
deviceType : 枚举
maximumPoints : int
pointerType : 枚举
uniqueId : pointingDeviceUniqueId

信号

grabChanged(QtObject grabber, 枚举 transition, PointerEvent event, 事件点 point)

详细描述

PointerDevice 是 QPointingDevice 类的 QML 名称。它拥有与 QPointingDevice 相同的属性和枚举。

属性说明

buttonCount : int

此属性表示可以检测到的设备上按钮的最大数量。

deviceType : enumeration

此属性表示生成 PointerEvent 的设备类型。

有效值有

常数	描述
`PointerDevice.Unknown`	无法识别设备。
`PointerDevice.Mouse`	鼠标。
`PointerDevice.TouchScreen`	触摸屏。
`PointerDevice.TouchPad`	触摸板或轨迹板。
`PointerDevice.Stylus`	图形平板上的笔。
`PointerDevice.Airbrush`	图形平板上的喷笔。
`PointerDevice.Puck`	带有十字线的数字化仪，在图形平板上。

另请参阅QInputDevice::DeviceType 和 PointerDeviceHandler::acceptedDevices。

maximumPoints : int

此属性表示可以检测到的最大同时触摸点（手指）数量。

pointerType : enumeration

此属性表示与 PointerDevice 交互的是什么。

此属性与deviceType之间存在冗余。例如，如果使用触摸屏，则deviceType是TouchScreen，而pointerType是Finger。但在绘图板上，通常可以用到笔的两端，程序需要区分它们。PointerDeviceHandler::acceptedDevices和PointerDeviceHandler::acceptedPointerTypes可以组合使用，以过滤特定处理程序应响应的事件子集。

有效值有

常数	描述
`PointerDevice.Unknown`	无法识别设备。
`PointerDevice.Generic`	鼠标或模拟鼠标的设备。
`PointerDevice.Finger`	触摸屏上的手指。
`PointerDevice.Pen`	图形平板上的笔。
`PointerDevice.Eraser`	绘图板上的橡皮擦。
`PointerDevice.Cursor`	带有十字线的数字化仪，在图形平板上。

另请参阅 QPointingDevice::PointerType和PointerDeviceHandler::acceptedPointerTypes。

uniqueId : pointingDeviceUniqueId

如果可用，此属性可能为设备提供唯一ID。例如，绘图板笔设备可能有唯一的序列号。

另请参阅 eventPoint和QEventPoint::uniqueId。

信号文档

grabChanged(QtObject grabber, enumeration transition, PointerEvent event, eventPoint point)

当在传递event期间，grabber对象在point上获得或失去独占或被动抓取时，会发出此信号。 The transition表示什么发生了，从grabber对象的角度来看，可能是Item或Input Handler。

transition的有效值包括

常数	描述
`PointerDevice.GrabExclusive`	grabber已接管处理point的主要责任。
`PointerDevice.UngrabExclusive`	grabber已放弃其之前的独家抓取。
`PointerDevice.CancelGrabExclusive`	grabber的独家抓取已被接管或取消。
`PointerDevice.GrabPassive`	grabber已获得被动抓取，以监视point。
`PointerDevice.UngrabPassive`	grabber已放弃其之前的被动抓取。
`PointerDevice.CancelGrabPassive`	之前的被动抓取异常终止。

注意：从一个对象到另一个对象的抓取过渡会产生两个信号，以通知一个对象已丢失其抓取，并通知有另一个抓取器。在其他情况下，在转换到或从非抓取状态过渡时，只发出一个信号。

注意：对应的手动操作是onGrabChanged。

另请参阅 QPointerEvent::setExclusiveGrabber(), QPointerEvent::addPassiveGrabber(), QPointerEvent::removePassiveGrabber和PointerHandler::grabChanged。