QEventPoint 类
QEventPoint 类提供了关于 QPointerEvent 中的点的信息。更多...
| 头文件 | #include <QEventPoint> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake | QT += gui |
| 自 | Qt 6.0 |
公共类型
属性
公共函数
| QEventPoint(int pointId, QEventPoint::State state, const QPointF &scenePosition, const QPointF &globalPosition) | |
| QEventPoint(const QEventPoint &other) | |
| QEventPoint(QEventPoint &&other) | |
| ~QEventPoint() | |
| const QPointingDevice * | device() const |
| QSizeF | ellipseDiameters() const |
| QPointF | globalGrabPosition() const |
| QPointF | globalLastPosition() const |
| QPointF | globalPosition() const |
| QPointF | globalPressPosition() const |
| QPointF | grabPosition() const |
| int | id() const |
| bool | isAccepted() const |
| QPointF | lastPosition() const |
| ulong | lastTimestamp() const |
| QPointF | normalizedPosition() const |
| QPointF | position() const |
| QPointF | pressPosition() const |
| ulong | pressTimestamp() const |
| qreal | pressure() const |
| qreal | rotation() const |
| QPointF | sceneGrabPosition() const |
| QPointF | sceneLastPosition() const |
| QPointF | scenePosition() const |
| QPointF | scenePressPosition() const |
| void | setAccepted(bool accepted = true) |
| QEventPoint::State | state() const |
| qreal | timeHeld() const |
| ulong | timestamp() const |
| QPointingDeviceUniqueId | uniqueId() const |
| QVector2D | velocity() const |
| bool | operator!=(const QEventPoint &other) const |
| QEventPoint & | operator=(const QEventPoint &other) |
| QEventPoint & | operator=(QEventPoint &&other) |
| bool | operator==(const QEventPoint &other) const |
成员类型文档
枚举 QEventPoint::State
标志 QEventPoint::States
指定此事件点的状态。
| 常量 | 值 | 描述 |
|---|---|---|
QEventPoint::Unknown | Qt::TouchPointUnknownState | 未知状态。 |
QEventPoint::Stationary | Qt::TouchPointStationary | 事件点未移动。 |
QEventPoint::Pressed | Qt::TouchPointPressed | 触摸点或按钮被按下。 |
QEventPoint::Updated | Qt::TouchPointMoved | 事件点已更新。 |
QEventPoint::Released | Qt::TouchPointReleased | 触摸点或按钮被释放。 |
States 类型是 QFlags<State> 的 typedef。它存储 State 值的 OR 组合。
属性文档
accepted : bool
此属性包含事件点的接受状态。
在基于窗口的应用程序中，此属性不使用，因为它只对接受或拒绝完整的 QInputEvent 有意义。
然而，在 Qt Quick 中，一个 Item 或事件处理程序只接受实际参与手势的 QTouchEvent 中的单独点是很正常的，而其他点可以被发送到其他项或处理程序。为了保持一致性，这也适用于任何 QPointerEvent；只在接受了一个 QPointerEvent 中的所有点后才进行传递。
访问函数
| bool | isAccepted() const |
| void | setAccepted(bool accepted = true) |
另请参阅QEvent::accepted。
[只读] device : QPointingDevice* const
此属性保存了事件点来源的指针设备。
访问函数
| const QPointingDevice * | device() const |
[只读] ellipseDiameters : const QSizeF
此属性保存了触摸点包围椭圆的宽度和高度。
返回值以逻辑像素为单位。大多数触摸屏不检测接触点的形状，鼠标或平板设备也无法检测，因此 null 尺寸是最常见的值。在某些触摸屏上，直径可能不为零且总是相等（椭圆被近似为一个圆）。
访问函数
| QSizeF | ellipseDiameters() const |
[只读] globalGrabPosition : const QPointF
此属性保存了此点被抓住的全局位置。
全局位置相对于屏幕或虚拟桌面。
访问函数
| QPointF | globalGrabPosition() const |
另请参阅globalPosition、grabPosition以及sceneGrabPosition。
[只读] globalLastPosition : const QPointF
此属性保存了此点从之前的按下或移动事件的全局位置。
全局位置相对于屏幕或虚拟桌面。
访问函数
| QPointF | globalLastPosition() const |
另请参阅globalPosition、lastPosition以及sceneLastPosition。
[只读] globalPosition : const QPointF
此属性保存了此点的全局位置。
全局位置相对于屏幕或虚拟桌面。
访问函数
| QPointF | globalPosition() const |
另请参阅globalPressPosition、position以及scenePosition。
[只读] globalPressPosition : const QPointF
此属性保存了此点被按下的全局位置。
全局位置相对于屏幕或虚拟桌面。
访问函数
| QPointF | globalPressPosition() const |
另请参阅globalPosition、pressPosition以及scenePressPosition。
[只读] grabPosition : const QPointF
此属性保存了此点被抓住的位置。
此位置相对于接收事件的小部件或项。
访问函数
| QPointF | grabPosition() const |
另请参阅 position.
[只读] id : const int
此属性保存此事件点的ID号。
注意：不要假设ID号从零开始或它们是连续的。由于底层驱动程序的工作方式，这种假设往往是错误的。
访问函数
| int | id() const |
[只读] lastPosition : const QPointF
此属性保存此点从上次按住或移动事件的位置。
此位置相对于接收事件的小部件或项。
访问函数
| QPointF | lastPosition() const |
另请参阅 position 和 pressPosition.
[只读] lastTimestamp : const ulong
此属性保存上一个包含此点的 QPointerEvent 的时间。
访问函数
| ulong | lastTimestamp() const |
另请参阅 globalLastPosition.
[只读] position : const QPointF
此属性保存此点的位置。
此位置相对于接收事件的小部件或项。
访问函数
| QPointF | position() const |
[只读] pressPosition : const QPointF
此属性保存此点被按住的位置。
此位置相对于接收事件的小部件或项。
访问函数
| QPointF | pressPosition() const |
另请参阅 position.
[只读] pressTimestamp : const ulong
此属性保存此点最后被按住的最新的时间。
访问函数
| ulong | pressTimestamp() const |
另请参阅 timestamp.
[只读] pressure : const qreal
此属性保存此点的压力。
返回值在范围 0.0 到 1.0 之间。
访问函数
| qreal | pressure() const |
[只读] rotation : const qreal
此属性保存此点的角度方向。
返回值以度为单位，其中默认值为零（向上指），负角度表示向左旋转，正角度表示向右旋转。大多数触摸屏不会检测旋转，因此零是最常见的值。
访问函数
| qreal | rotation() const |
[只读] sceneGrabPosition : const QPointF
此属性保存在此点被捕获的场景位置。
场景位置是指在QQuickWindow中处理时相对于QQuickItem::event()的位置，在QGraphicsScene坐标系中如果由QGraphicsItem::touchEvent()的覆盖处理，或者在小部件应用中的窗口位置。
访问函数
| QPointF | sceneGrabPosition() const |
参阅：scenePosition、grabPosition和globalGrabPosition。
[只读] sceneLastPosition : const QPointF
此属性保存了从上一个按下或移动事件到此点的场景位置。
场景位置是指在QQuickWindow中处理时相对于QQuickItem::event()的位置，在QGraphicsScene坐标系中如果由QGraphicsItem::touchEvent()的覆盖处理，或者在小部件应用中的窗口位置。
访问函数
| QPointF | sceneLastPosition() const |
参阅：scenePosition和scenePressPosition。
[只读] scenePosition : const QPointF
此属性保存了此点的场景位置。
场景位置是指在QQuickWindow中处理时相对于QQuickItem::event()的位置，在QGraphicsScene坐标系中如果由QGraphicsItem::touchEvent()的覆盖处理，或者在小部件应用中的窗口位置。
访问函数
| QPointF | scenePosition() const |
参阅：scenePressPosition、position和globalPosition。
[只读] scenePressPosition : const QPointF
此属性保存了按下此点的场景位置。
场景位置是指在QQuickWindow中处理时相对于QQuickItem::event()的位置，在QGraphicsScene坐标系中如果由QGraphicsItem::touchEvent()的覆盖处理，或者在小部件应用中的窗口位置。
访问函数
| QPointF | scenePressPosition() const |
参阅：scenePosition、pressPosition和globalPressPosition。
[只读] state : const State
此属性保存了事件点的当前状态。
访问函数
| QEventPoint::State | state() const |
[只读] timeHeld : const qreal
此属性保存了自按下此点且未释放起经过的时间（以秒为单位）。
访问函数
| qreal | timeHeld() const |
[只读] timestamp : const ulong
此属性保存了最后一次此点包含在QPointerEvent中的时间。
访问函数
| ulong | timestamp() const |
[只读] uniqueId : const QPointingDeviceUniqueId
此属性保存了此点或令牌的唯一ID（如果有）。
这通常是无效的（请参阅isValid），因为触摸屏无法唯一标识手指。
当它来自QTabletEvent时，它标识了正在使用的笔的序列号。
当TUIO驱动的触屏设备支持该功能时，它可能会识别特定的标识符对象。
访问函数
| QPointingDeviceUniqueId | uniqueId() const |
[只读] velocity : const QVector2D
此属性保存一个速度向量，以像素每秒为单位，在屏幕或桌面坐标系统中。
注意：如果设备的功能包括QInputDevice::Velocity，则表示速度来自操作系统（可能是触摸硬件或驱动程序提供）。但通常不会设置Velocity功能，表示速度是Qt通过简单卡尔曼滤波计算的平均速度，而不是瞬时值。实际上，这显示了用户在上一个或几个事件中拖动此点的速度和方向，最近的事件影响最大。
访问函数
| QVector2D | velocity() const |
成员函数文档
QEventPoint::QEventPoint(int pointId, QEventPoint::State state, const QPointF &scenePosition, const QPointF &globalPosition)
使用指定的pointId、state、scenePosition和globalPosition构造事件点。
[noexcept] QEventPoint::QEventPoint(const QEventPoint &other)
通过浅复制other构造事件点。
[noexcept] QEventPoint::QEventPoint(QEventPoint &&other)
通过移动other构造事件点。
[noexcept] QEventPoint::~QEventPoint()
销毁事件点。
QPointF QEventPoint::normalizedPosition() const
返回该点的归一化位置。
坐标通过将globalPosition()转换为QInputDevice::availableVirtualGeometry的空间来计算，即(0, 0)是左上角，而(1, 1)是右下角。
另请参阅：globalPosition。
[noexcept] bool QEventPoint::operator!=(const QEventPoint &other) const
如果此事件点不等于other，则返回true，否则返回false。
[noexcept] QEventPoint &QEventPoint::operator=(const QEventPoint &other)
将other分配给此事件点，并返回对此事件点的引用。
[noexcept] QEventPoint &QEventPoint::operator=(QEventPoint &&other)
将 other 移动赋值给此事件点实例。
[noexcept] bool QEventPoint::operator==(const QEventPoint &other) const
如果此事件点等于 other，则返回 true，否则返回 false。
© 2024Qt公司有限公司。此处包含的文档贡献归各自所有者所有。此处提供的文档是根据自由软件基金会发布的GNU自由文档许可协议版本1.3的条款提供的。Qt和相应的标志是芬兰和/或世界各地的Qt公司有限合伙企业和子公司的商标。所有其他商标均属于其各自所有者。
