PySide6.QtGui.QEventPoint¶

class QEventPoint¶

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

概要¶

属性¶

• acceptedᅟ - 事件点的接受状态

• deviceᅟ - 此事件点源自的指向设备

• ellipseDiametersᅟ - 触摸点边界椭圆的宽度和高度

• globalGrabPositionᅟ - 抓取此点的全局位置

• globalLastPositionᅟ - 该点在上一次按下或移动事件中的全局位置

• globalPositionᅟ - 该点的全局位置

• globalPressPositionᅟ - 此点被按下的全局位置

• grabPositionᅟ - 抓取此点的位置

• idᅟ - 此事件点的ID号

• lastPositionᅟ - 该点在上一次按下或移动事件中的位置

• lastTimestampᅟ - 包含此点的前一个QPointerEvent的时间

• positionᅟ - 这个点的位置

• pressPositionᅟ - 该点被按下的位置

• pressTimestampᅟ - 该点最近被按下的时间

• pressureᅟ - 该点的压力

• rotationᅟ - 该点的角度方向

• sceneGrabPositionᅟ - 抓取此点时的场景位置

• sceneLastPositionᅟ - 此点在上一次按下或移动事件中的场景位置

• scenePositionᅟ - 该点的场景位置

• scenePressPositionᅟ - 按下此点时的场景位置

• stateᅟ - 事件点的当前状态

• timeHeldᅟ - 自按下此点以来未释放的持续时间，以秒为单位

• timestampᅟ - 该点最近一次被包含在QPointerEvent中的时间

• uniqueIdᅟ - 此点或令牌的唯一ID（如果有）

• velocityᅟ - 速度向量，单位为每秒像素，在屏幕或桌面的坐标系中

方法¶

• def __init__()

• def device()

• def ellipseDiameters()

• def globalGrabPosition()

• def globalLastPosition()

• def globalPosition()

• def globalPressPosition()

• def grabPosition()

• def id()

• def isAccepted()

• def lastNormalizedPos()

• def lastPos()

• def lastPosition()

• def lastScenePos()

• def lastScreenPos()

• def lastTimestamp()

• def normalizedPos()

• def normalizedPosition()

• def __ne__()

• def __eq__()

• def pos()

• def position()

• def pressPosition()

• def pressTimestamp()

• def pressure()

• def rotation()

• def sceneGrabPosition()

• def sceneLastPosition()

• def scenePos()

• def scenePosition()

• def scenePressPosition()

• def screenPos()

• def setAccepted()

• def startNormalizedPos()

• def startPos()

• def startScenePos()

• def startScreenPos()

• def state()

• def swap()

• def timeHeld()

• def timestamp()

• def uniqueId()

• def velocity()

注意

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

详细描述¶

class State¶

指定此事件点的状态。

常量	描述
QEventPoint.Unknown	未知状态。
QEventPoint.Stationary	事件点没有移动。
QEventPoint.Pressed	触摸点或按钮被按下。
QEventPoint.Updated	事件点已更新。
QEventPoint.Released	触摸点或按钮已释放。

注意

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

property acceptedᅟ: bool¶

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

在小部件基础的应用程序中，此属性不被使用，因为对于小部件来说，接受或拒绝一个完整的QInputEvent才有意义。

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

另请参阅

accepted

Access functions:

• isAccepted()

• setAccepted()

property deviceᅟ: QPointingDevice¶

此属性保存此事件点源自的指向设备。

Access functions:

• device()

property ellipseDiametersᅟ: QSizeF¶

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

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

Access functions:

• ellipseDiameters()

property globalGrabPositionᅟ: QPointF¶

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

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

另请参阅

globalPosition grabPosition sceneGrabPosition

Access functions:

• globalGrabPosition()

property globalLastPositionᅟ: QPointF¶

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

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

另请参阅

globalPosition lastPosition sceneLastPosition

Access functions:

• globalLastPosition()

property globalPositionᅟ: QPointF¶

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

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

另请参阅

globalPressPosition position scenePosition

Access functions:

• globalPosition()

property globalPressPositionᅟ: QPointF¶

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

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

另请参阅

globalPosition pressPosition scenePressPosition

Access functions:

• globalPressPosition()

property grabPositionᅟ: QPointF¶

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

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

另请参阅

position

Access functions:

• grabPosition()

property idᅟ: int¶

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

注意

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

Access functions:

• id()

property lastPositionᅟ: QPointF¶

此属性保存此点相对于之前按下或移动事件的位置。

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

另请参阅

position pressPosition

Access functions:

• lastPosition()

property lastTimestampᅟ: int¶

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

另请参阅

globalLastPosition

Access functions:

• lastTimestamp()

property positionᅟ: QPointF¶

此属性保存此点的位置。

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

Access functions:

• position()

property pressPositionᅟ: QPointF¶

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

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

另请参阅

position

Access functions:

• pressPosition()

property pressTimestampᅟ: int¶

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

另请参阅

timestamp

Access functions:

• pressTimestamp()

property pressureᅟ: float¶

此属性保存此点的压力。

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

Access functions:

• pressure()

property rotationᅟ: float¶

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

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

Access functions:

• rotation()

property sceneGrabPositionᅟ: QPointF¶

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

场景位置是相对于QQuickWindow的位置，如果在QQuickItem::event()中处理，则是在QGraphicsScene坐标中，如果由QGraphicsItem::touchEvent()的重写处理，则是在窗口位置的小部件应用程序中。

另请参阅

scenePosition grabPosition globalGrabPosition

Access functions:

• sceneGrabPosition()

property sceneLastPositionᅟ: QPointF¶

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

场景位置是相对于QQuickWindow的位置，如果在QQuickItem::event()中处理，则是在QGraphicsScene坐标中，如果由QGraphicsItem::touchEvent()的重写处理，则是在窗口位置的小部件应用程序中。

另请参阅

scenePosition scenePressPosition

Access functions:

• sceneLastPosition()

property scenePositionᅟ: QPointF¶

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

场景位置是相对于QQuickWindow的位置，如果在QQuickItem::event()中处理，则是在QGraphicsScene坐标中，如果由QGraphicsItem::touchEvent()的重写处理，或者在小部件应用程序中的窗口位置。

另请参阅

scenePressPosition position globalPosition

Access functions:

• scenePosition()

property scenePressPositionᅟ: QPointF¶

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

场景位置是相对于QQuickWindow的位置，如果在QQuickItem::event()中处理，则是在QGraphicsScene坐标中，如果由QGraphicsItem::touchEvent()的重写处理，则是在窗口位置的小部件应用程序中。

另请参阅

scenePosition pressPosition globalPressPosition

Access functions:

• scenePressPosition()

property stateᅟ: QEventPoint.State¶

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

Access functions:

• state()

property timeHeldᅟ: float¶

此属性保存自按下此点以来未释放的持续时间，以秒为单位。

另请参阅

pressTimestamp timestamp

Access functions:

• timeHeld()

property timestampᅟ: int¶

此属性保存此点最近一次被包含在QPointerEvent中的时间。

另请参阅

timestamp()

Access functions:

• timestamp()

property uniqueIdᅟ: QPointingDeviceUniqueId¶

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

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

当它来自QTabletEvent时，它标识了正在使用的触控笔的序列号。

当TUIO驱动程序与支持它们的触摸屏一起使用时，它可能会识别一个特定的标记（基准对象）。

Access functions:

• uniqueId()

property velocityᅟ: QVector2D¶

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

注意

如果设备的功能包括Velocity，这意味着速度来自操作系统（可能是触摸硬件或驱动程序提供的）。但通常Velocity功能未设置，表示速度是由Qt计算的，使用简单的卡尔曼滤波器提供平滑的平均速度，而不是瞬时值。实际上，它告诉用户在过去几个事件中拖动该点的速度有多快以及方向如何，最近的事件影响最大。

另请参阅

capabilities() device()

Access functions:

• velocity()

__init__(other)¶

Parameters:

其他 – QEventPoint

通过浅拷贝other来构造一个事件点。

__init__([id=-1[, device=None]])

Parameters:

• id – int

• 设备 – QPointingDevice

__init__(pointId, state, scenePosition, globalPosition)

Parameters:

• pointId – int

• state – State

• 场景位置 – QPointF

• globalPosition – QPointF

使用给定的 pointId、state、scenePosition 和 globalPosition 构造一个事件点。

device()¶

Return type:

QPointingDevice

属性 deviceᅟ 的获取器。

ellipseDiameters()¶

Return type:

QSizeF

属性 ellipseDiametersᅟ 的获取器。

globalGrabPosition()¶

Return type:

QPointF

属性 globalGrabPositionᅟ 的获取器。

globalLastPosition()¶

Return type:

QPointF

属性 globalLastPositionᅟ 的获取器。

globalPosition()¶

Return type:

QPointF

属性 globalPositionᅟ 的获取器。

globalPressPosition()¶

Return type:

QPointF

属性 globalPressPositionᅟ 的获取器。

grabPosition()¶

Return type:

QPointF

属性 grabPositionᅟ 的获取器。

id()¶

Return type:

整数

属性 idᅟ 的获取器。

isAccepted()¶

Return type:

布尔

属性 acceptedᅟ 的获取器。

lastNormalizedPos()¶

Return type:

QPointF

注意

此函数已弃用。

请使用 globalLastPosition() 代替。

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

坐标被归一化到availableVirtualGeometry()，即(0, 0)表示左上角，(1, 1)表示右下角。

另请参阅

normalizedPosition() globalPressPosition()

lastPos()¶

Return type:

QPointF

注意

此函数已弃用。

lastPosition()¶

Return type:

QPointF

属性 lastPositionᅟ 的获取器。

lastScenePos()¶

Return type:

QPointF

注意

此函数已弃用。

lastScreenPos()¶

Return type:

QPointF

注意

此函数已弃用。

lastTimestamp()¶

Return type:

整数

属性 lastTimestampᅟ 的获取器。

normalizedPos()¶

Return type:

QPointF

注意

此函数已弃用。

请使用 normalizedPosition() 代替。

normalizedPosition()¶

Return type:

QPointF

返回此点的归一化位置。

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

另请参阅

globalPosition

__ne__(other)¶

Parameters:

其他 – QEventPoint

Return type:

布尔

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

__eq__(other)¶

Parameters:

其他 – QEventPoint

Return type:

布尔

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

pos()¶

Return type:

QPointF

注意

此函数已弃用。

使用 position() 代替。

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

position()¶

Return type:

QPointF

属性 positionᅟ 的获取器。

pressPosition()¶

Return type:

QPointF

属性 pressPositionᅟ 的获取器。

pressTimestamp()¶

Return type:

整数

属性 pressTimestampᅟ 的获取器。

pressure()¶

Return type:

浮点数

属性 pressureᅟ 的获取器。

rotation()¶

Return type:

浮点数

属性 rotationᅟ 的获取器。

sceneGrabPosition()¶

Return type:

QPointF

属性 sceneGrabPositionᅟ 的获取器。

sceneLastPosition()¶

Return type:

QPointF

属性 sceneLastPositionᅟ 的获取器。

scenePos()¶

Return type:

QPointF

注意

此函数已弃用。

scenePosition()¶

Return type:

QPointF

属性 scenePositionᅟ 的获取器。

scenePressPosition()¶

Return type:

QPointF

属性 scenePressPositionᅟ 的获取器。

screenPos()¶

Return type:

QPointF

注意

此函数已弃用。

setAccepted([accepted=true])¶

Parameters:

accepted – 布尔值

另请参阅

isAccepted()

属性 acceptedᅟ 的设置器。

startNormalizedPos()¶

Return type:

QPointF

注意

此函数已弃用。

请使用 globalPressPosition() 代替。

返回此点的标准化按压位置。

startPos()¶

Return type:

QPointF

注意

此函数已弃用。

startScenePos()¶

Return type:

QPointF

注意

此函数已弃用。

startScreenPos()¶

Return type:

QPointF

注意

此函数已弃用。

state()¶

Return type:

State

属性 stateᅟ 的获取器。

swap(other)¶

Parameters:

其他 – QEventPoint

timeHeld()¶

Return type:

浮点数

属性 timeHeldᅟ 的获取器。

timestamp()¶

Return type:

整数

属性 timestampᅟ 的获取器。

uniqueId()¶

Return type:

QPointingDeviceUniqueId

属性 uniqueIdᅟ 的获取器。

velocity()¶

Return type:

QVector2D

属性 velocityᅟ 的获取器。