class QEventPoint#

QEventPoint 类提供了有关 QPointerEvent 中一个点的信息。 更多…

概要#

属性#

方法#

注意

本说明文档可能包含从C++自动翻译为Python的片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译有问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE创建票据来告知我们

详细描述#

类 State#

指定此事件点的状态。

常量

描述

QEventPoint.Unknown

未知状态。

QEventPoint.Stationary

事件点未移动。

QEventPoint.Pressed

触摸点或按钮被按下。

QEventPoint.Updated

事件点已更新。

QEventPoint.Released

触摸点或按钮被释放。

注意

在使用了from __feature__ import true_property时可以直接使用属性，否则通过访问函数使用。

property accepted: bool#

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

在基于小部件的应用程序中，此属性未使用，因为它只对完全接受或拒绝 QInputEvent 的小部件有意义。

然而，在 Qt Quick 中，通常是项或事件处理器仅接受 QTouchEvent 中实际参与手势的各个点，而其他点可以传递给其他项或处理器。为了保持一致性，这适用于任何 QPointerEvent；并且只有在所有点在一个 QPointerEvent 中都已被接受时，才会进行传递。

另请参阅

accepted

访问函数
property device: QPointingDevice#

此属性保存此事件点的来源指针设备。

访问函数
property ellipseDiameters: QSizeF#

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

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

访问函数
property globalGrabPosition: QPointF#

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

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

访问函数
property globalLastPosition: QPointF#

该属性持有此点从上次按下或移动事件的全局位置。

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

访问函数
属性globalPositionᅟ: QPointF#

该属性持有此点的全局位置。

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

访问函数
属性globalPressPositionᅟ: QPointF#

该属性持有此点被按下时的全局位置。

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

访问函数
属性grabPositionᅟ: QPointF#

该属性持有此点被捕获时的位置。

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

另请参阅

position

访问函数
属性idᅟ: int#

该属性持有此事件点的ID号。

注意

不要假设ID号从零开始或它们是连续的。这样的假设通常由于底层驱动程序的工作方式而往往是错误的。

访问函数
属性lastPositionᅟ: QPointF#

该属性持有从上次按下或移动事件到此点的位置。

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

另请参阅

position pressPosition

访问函数
属性 lastTimestamp: int#

此属性保存上一个包含此点的 QPointerEvent 的时间。

另请参阅

globalLastPosition

访问函数
属性 position: QPointF#

此属性保存此点的位置。

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

访问函数
属性 pressPosition: QPointF#

此属性保存此点被按下的位置。

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

另请参阅

position

访问函数
属性 pressTimestamp: int#

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

另请参阅

timestamp

访问函数
属性 pressure: float#

此属性保存此点的压力。

返回值在 0.0 到 1.0 的范围内。

访问函数
属性 rotation: float#

此属性保存此点的角度方向。

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

访问函数
属性 sceneGrabPosition: QPointF#

此属性保存此点被捕获的舞台位置。

舞台位置相对于 QQuickWindow，如果通过 QQuickItem::event() 处理，或者在 QGraphicsItem::touchEvent() 的重写中处理，则为 QGraphicsScene 坐标；在窗口小应用程序中为窗口位置。

访问函数
属性 sceneLastPosition: QPointF#

此属性保存了从之前的按压力或移动事件到该点的场景位置。

舞台位置相对于 QQuickWindow，如果通过 QQuickItem::event() 处理，或者在 QGraphicsItem::touchEvent() 的重写中处理，则为 QGraphicsScene 坐标；在窗口小应用程序中为窗口位置。

访问函数
属性 scenePosition: QPointF#

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

舞台位置相对于 QQuickWindow，如果通过 QQuickItem::event() 处理，或者在 QGraphicsItem::touchEvent() 的重写中处理，则为 QGraphicsScene 坐标；在窗口小应用程序中为窗口位置。

访问函数
属性 scenePressPosition: QPointF#

此属性保存了该点被按下的场景位置。

舞台位置相对于 QQuickWindow，如果通过 QQuickItem::event() 处理，或者在 QGraphicsItem::touchEvent() 的重写中处理，则为 QGraphicsScene 坐标；在窗口小应用程序中为窗口位置。

访问函数
属性 state: QEventPoint.State#

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

访问函数
属性 timeHeld: float#

此属性保存了自该点被按下且未释放的时间，单位为秒。

另请参阅

pressTimestamp timestamp

访问函数
propertytimestamp: int#

该属性保存的是此点最近被包含在QPointerEvent中的时间...

另请参阅

timestamp()

访问函数
propertyuniqueId:QPointingDeviceUniqueId#

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

通常无效（参见isValid），因为触摸屏无法唯一识别手指。

当来自QTabletEvent时，它表示正在使用钢笔的序列号。

当与支持它们的触摸屏结合使用TUIO驱动程序时，它可以标识特定的令牌（参考对象）。

访问函数
propertyvelocity:QVector2D#

该属性保存一个速度矢量，以屏幕或桌面坐标系统中的每秒像素单位表示。

注意

如果设备的功能包括Velocity，则表示速度来自操作系统（可能是触摸硬件或驱动程序提供）。但是，通常不设置Velocity功能，表示速度是通过Qt计算得出的，使用简单的卡尔曼滤波器提供一个平滑的平均速度，而不是瞬时值。有效地说明了用户在最后几个事件中如何以及如何拖动此点，最近的事件影响最大。

另请参阅

capabilities device

访问函数
__init__([id=-1[, device=None]])#
参数：
__init__(other)
参数：

其他 – QEventPoint

通过复制other来构建一个事件点。

__init__(pointId, state, scenePosition, globalPosition)
参数：

通过给定的pointId、state、scenePosition和globalPosition来构建一个事件点。

device()#
返回类型：:

QPointingDevice

属性device的获取器。

ellipseDiameters()#
返回类型：:

QSizeF

属性ellipseDiameters的获取器。

globalGrabPosition()#
返回类型：:

QPointF

属性globalGrabPosition的获取器。

globalLastPosition()#
返回类型：:

QPointF

属性globalLastPosition的获取器。

globalPosition()#
返回类型：:

QPointF

属性globalPosition的获取器。

globalPressPosition()#
返回类型：:

QPointF

属性globalPressPosition的获取器。

grabPosition()#
返回类型：:

QPointF

属性grabPosition的获取器。

id()#
返回类型：:

整型

属性 id 的获取器。

isAccepted()#
返回类型：:

布尔型

属性 accepted 的获取器。

lastNormalizedPos()#
返回类型：:

QPointF

注意

此函数已弃用。

请使用 globalLastPosition() 代替。

返回此点从上次按下或移动事件以来的归一化位置。

坐标已归一化为 availableVirtualGeometry() ，即 (0, 0) 为左上角， (1, 1) 为右下角。

lastPos()#
返回类型：:

QPointF

注意

此函数已弃用。

lastPosition()#
返回类型：:

QPointF

属性 lastPosition 的获取器。

lastScenePos()#
返回类型：:

QPointF

注意

此函数已弃用。

lastScreenPos()#
返回类型：:

QPointF

注意

此函数已弃用。

lastTimestamp()#
返回类型：:

整型

属性 lastTimestamp 的获取器。

normalizedPos()#
返回类型：:

QPointF

注意

此函数已弃用。

请使用 normalizedPosition() 代替。

normalizedPosition()#
返回类型：:

QPointF

返回此点的归一化位置。

坐标是通过将globalPosition()转换为availableVirtualGeometry()的空间来计算的，即(0, 0)为左上角，而(1, 1)为右下角。

另请参阅

globalPosition

__ne__(other)#
参数：

其他 – QEventPoint

返回类型：:

布尔型

如果此事件点不等于other，则返回true，否则返回false。

__eq__(other)#
参数：

其他 – QEventPoint

返回类型：:

布尔型

如果此事件点等于other，则返回true，否则返回false。

pos()#
返回类型：:

QPointF

注意

此函数已弃用。

请使用position()替代。

返回此点的位置，相对于接收事件的小部件或项。

position()#
返回类型：:

QPointF

属性position的获取器。

pressPosition()#
返回类型：:

QPointF

属性pressPosition的获取器。

pressTimestamp()#
返回类型：:

整型

属性pressTimestamp的获取器。

pressure()#
返回类型：:

float

属性pressure的获取器。

rotation()#
返回类型：:

float

属性rotation的获取器。

sceneGrabPosition()#
返回类型：:

QPointF

属性 sceneGrabPositionᅟ 的获取器。

sceneLastPosition()#
返回类型：:

QPointF

属性 sceneLastPositionᅟ 的获取器。

scenePos()#
返回类型：:

QPointF

注意

此函数已弃用。

scenePosition()#
返回类型：:

QPointF

属性 scenePositionᅟ 的获取器。

scenePressPosition()#
返回类型：:

QPointF

属性 scenePressPositionᅟ 的获取器。

screenPos()#
返回类型：:

QPointF

注意

此函数已弃用。

setAccepted([accepted=true])#
参数：

accepted – bool

另请参阅

isAccepted()

属性 acceptedᅟ 的设置器。

startNormalizedPos()#
返回类型：:

QPointF

注意

此函数已弃用。

请使用 globalPressPosition() 代替。

返回该点的归一化按下位置。

startPos()#
返回类型：:

QPointF

注意

此函数已弃用。

startScenePos()#
返回类型：:

QPointF

注意

此函数已弃用。

startScreenPos()#
返回类型：:

QPointF

注意

此函数已弃用。

state()#
返回类型：:

状态

属性 stateᅟ 的获取器。

swap(other)#
参数：

其他 – QEventPoint

timeHeld()#
返回类型：:

float

属性 timeHeldᅟ 的获取器。

timestamp()#
返回类型：:

整型

属性 timestampᅟ 的获取器。

uniqueId()#
返回类型：:

QPointingDeviceUniqueId

属性uniqueIdᅟ的获取器。

velocity()#
返回类型：:

QVector2D

属性velocityᅟ的获取器。