QEventPoint Class

属性文档

accepted : bool

该属性保存事件点的接受状态。

在基于 Widget 的应用程序中，这个属性不会被使用，因为只有 Widget 接受或拒绝一个完整的QInputEvent 才有意义。

但在Qt Quick 中，项目或事件处理程序通常只接受QTouchEvent 中实际参与手势的单个点，而其他点则可以传递给其他项目或处理程序。为了保持一致，这适用于任何QPointerEvent ；只有当QPointerEvent 中的所有点都被接受后，才会进行交付。

访问功能：

另请参阅 QEvent::accepted 。

[read-only] device : const QPointingDevice*

该属性用于保存事件点的指向设备。

访问功能：

[read-only] ellipseDiameters : const QSizeF

该属性保存触摸点边界椭圆的宽度和高度。

返回值以逻辑像素为单位。大多数触摸屏无法检测接触点的形状，鼠标或平板设备也无法检测，因此最常用的值是空大小。在某些触摸屏上，直径可能不为零且始终相等（椭圆近似为圆）。

访问功能：

[read-only] globalGrabPosition : const QPointF

此属性保存抓取此点时的全局位置。

全局位置相对于屏幕或虚拟桌面。

访问功能：

另请参阅 globalPosition,grabPosition, 和sceneGrabPosition 。

[read-only] globalLastPosition : const QPointF

此属性保存此点在上一次按下或移动事件中的全局位置。

全局位置相对于屏幕或虚拟桌面。

访问功能：

另请参阅 globalPosition,lastPosition, 和sceneLastPosition 。

[read-only] globalPosition : const QPointF

此属性保存此点的全局位置。

全局位置相对于屏幕或虚拟桌面。

访问功能：

另请参阅 globalPressPosition,position, 和scenePosition 。

[read-only] globalPressPosition : const QPointF

此属性保存按下此点时的全局位置。

全局位置相对于屏幕或虚拟桌面。

访问功能：

另请参阅 globalPosition,pressPosition, 和scenePressPosition 。

[read-only] grabPosition : const QPointF

该属性用于保存该点被抓取时的位置。

该位置相对于接收事件的部件或项目。

访问功能：

另请参阅 position 。

[read-only] id : const int

此属性保存此事件点的 ID 编号。

访问功能：

[read-only] lastPosition : const QPointF

此属性保存此点在上一次按下或移动事件中的位置。

该位置相对于接收事件的部件或项目。

访问功能：

另请参阅 position 和pressPosition 。

[read-only] lastTimestamp : const ulong

该属性保存从包含该点的上一个QPointerEvent 开始的时间。

访问功能：

另请参阅 globalLastPosition 。

[read-only] position : const QPointF

此属性保存此点的位置。

该位置相对于接收事件的部件或项目。

访问功能：

[read-only] pressPosition : const QPointF

该属性用于保存该点被按下时的位置。

该位置相对于接收事件的 widget 或项目。

访问功能：

另请参阅 position 。

[read-only] pressTimestamp : const ulong

此属性保存按下此点的最近时间。

访问功能：

另请参阅 timestamp 。

[read-only] pressure : const qreal

该属性保存此点的压力。

返回值范围为0.0 至1.0 。

访问功能：

[read-only] rotation : const qreal

该属性用于保存该点的角度方向。

返回值的单位是度，其中零（默认值）表示手指、令牌或触控笔朝上，负角表示向左旋转，正角表示向右旋转。大多数触摸屏无法检测旋转，因此零是最常用的值。

访问功能：

[read-only] sceneGrabPosition : const QPointF

此属性保存抓取此点时的场景位置。

如果在QQuickItem::event() 中处理，则场景位置是相对于QQuickWindow 的位置；如果通过重载 QGraphicsItem::touchEvent() 处理，则场景位置是QGraphicsScene 坐标；在 widget 应用程序中，则是窗口位置。

访问函数：

另请参阅 scenePosition,grabPosition, 和globalGrabPosition 。

[read-only] sceneLastPosition : const QPointF

此属性保存此点在上一次按下或移动事件中的场景位置。

如果在QQuickItem::event() 中处理，则场景位置是相对于QQuickWindow 的位置；如果通过重载 QGraphicsItem::touchEvent() 来处理，则场景位置是以QGraphicsScene 坐标表示的位置；在 widget 应用程序中，场景位置则是窗口位置。

访问函数：

另请参阅 scenePosition 和scenePressPosition 。

[read-only] scenePosition : const QPointF

此属性保存此点的场景位置。

如果在QQuickItem::event() 中处理，场景位置就是相对于QQuickWindow 的位置；如果通过重载 QGraphicsItem::touchEvent() 处理，场景位置就是以QGraphicsScene 坐标表示的位置；在 widget 应用程序中，场景位置就是窗口位置。

访问函数：

另请参阅 scenePressPosition,position, 和globalPosition 。

[read-only] scenePressPosition : const QPointF

此属性保存按下此点时的场景位置。

如果在QQuickItem::event() 中处理，则场景位置是相对于QQuickWindow 的位置；如果通过覆盖 QGraphicsItem::touchEvent() 来处理，则场景位置是以QGraphicsScene 坐标表示的位置；在 widget 应用程序中，则是窗口位置。

访问函数：

另请参阅 scenePosition,pressPosition, 和globalPressPosition 。

[read-only] state : const State

该属性保存事件点的当前状态。

访问功能：

[read-only] timeHeld : const qreal

该属性保存该点按下后未释放的持续时间（以秒为单位）。

访问功能：

另请参阅 pressTimestamp 和timestamp 。

[read-only] timestamp : const ulong

该属性保存了QPointerEvent 中包含该点的最近时间。

访问函数：

另请参阅 QPointerEvent::timestamp() 。

[read-only] uniqueId : const QPointingDeviceUniqueId

此属性保存此点或标记的唯一 ID（如果有）。

它通常是无效的（参见isValid()) ，因为触摸屏无法唯一识别手指。

当它来自QTabletEvent 时，可识别使用中的触控笔序列号。

当 TUIO 驱动程序与支持这些标记的触摸屏一起使用时，它可以识别特定的标记（靶标）。

访问功能：

[read-only] velocity : const QVector2D

此属性保存屏幕或桌面坐标系中的速度向量，单位为像素/秒。

访问功能：

另请参阅 QInputDevice::capabilities() 和QInputEvent::device()。