QPinchGesture 类
QPinchGesture 类描述了用户执行的多指捏合手势。 更多信息...
| 头文件 | #include <QPinchGesture> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake | QT += widgets |
| 继承 | QGesture |
公共类型
| enum | ChangeFlag { ScaleFactorChanged, RotationAngleChanged, CenterPointChanged } |
| flags | ChangeFlags |
属性
|
|
公共函数
| virtual | ~QPinchGesture() |
| QPointF | centerPoint() const |
| QPinchGesture::ChangeFlags | changeFlags() const |
| QPointF | lastCenterPoint() const |
| qreal | lastRotationAngle() const |
| qreal | lastScaleFactor() const |
| qreal | rotationAngle() const |
| qreal | scaleFactor() const |
| void | setCenterPoint(const QPointF &value) |
| void | setChangeFlags(QPinchGesture::ChangeFlags value) |
| void | setLastCenterPoint(const QPointF &value) |
| void | setLastRotationAngle(qreal value) |
| void | setLastScaleFactor(qreal value) |
| void | setRotationAngle(qreal value) |
| void | setScaleFactor(qreal value) |
| void | setStartCenterPoint(const QPointF &value) |
| void | setTotalChangeFlags(QPinchGesture::ChangeFlags value) |
| void | setTotalRotationAngle(qreal value) |
| void | setTotalScaleFactor(qreal value) |
| QPointF | startCenterPoint() const |
| QPinchGesture::ChangeFlags | totalChangeFlags() const |
| qreal | totalRotationAngle() const |
| qreal | totalScaleFactor() const |
详细描述
捏合手势是一种触摸用户输入形式，用户通常用拇指和手指触摸输入设备的两个点，然后移动它们靠得更近或更远以改变缩放因子、缩放或用户界面的细节级别。
有关Qt中手势处理概述以及如何在您的应用程序中使用手势的信息，请参阅Widgets和Graphics View中的手势文档。
为了避免反复使用相同的手势，用户可以在一个位置继续触摸输入设备，将第二次触摸应用于新点，继续手势。在这种情况下，含有QPinchGesture实例的事件将继续发送到目标对象，该实例处于Qt::GestureUpdated状态。
另请参阅QPanGesture和QSwipeGesture。
成员类型文档
枚举QPinchGesture::ChangeFlag
标志QPinchGesture::ChangeFlags
此枚举描述了可以发生更改的手势对象属性。
| 常量 | 值 | 描述 |
|---|---|---|
QPinchGesture::ScaleFactorChanged | 0x1 | scaleFactor持有的缩放因子已更改。 |
QPinchGesture::RotationAngleChanged | 0x2 | rotationAngle持有的旋转角度已更改。 |
QPinchGesture::CenterPointChanged | 0x4 | centerPoint持有的中心点已更改。 |
ChangeFlags类型是QFlags<ChangeFlag>的类型别名。它存储ChangeFlag值的组合。
属性文档
centerPoint : QPointF
此属性当前保存中心点
中心点是手势中两个输入点之间的中点。
访问函数
| QPointF | centerPoint() const |
| void | setCenterPoint(const QPointF &value) |
另请参阅startCenterPoint和lastCenterPoint。
changeFlags : ChangeFlags
此属性保存当前步骤中更改的手势属性
此属性指示自上次手势事件包含关于此手势的信息以来哪些属性已更改。您可以使用这些信息来确定您的用户界面哪些方面需要更新。
访问函数
| QPinchGesture::ChangeFlags | changeFlags() const |
| void | setChangeFlags(QPinchGesture::ChangeFlags value) |
另请参阅totalChangeFlags、scaleFactor、rotationAngle和centerPoint。
lastCenterPoint : QPointF
该属性保存了该手势记录的中心点最后一个位置
访问函数
| QPointF | lastCenterPoint() const |
| void | setLastCenterPoint(const QPointF &value) |
参见centerPoint和startCenterPoint.
lastRotationAngle : qreal
该属性保存了手势运动所覆盖的最后一个报告的角度
最后一个旋转角度是当为该手势触发了前一个手势事件时所报告的rotationAngle属性中的角度。
访问函数
| qreal | lastRotationAngle() const |
| void | setLastRotationAngle(qreal value) |
参见rotationAngle和totalRotationAngle.
lastScaleFactor : qreal
该属性保存了该手势记录的最后一个缩放因子
最后一个缩放因子包含在scaleFactor属性中报告的缩放因子，当前一个手势事件包含有关该手势的信息时。
如果没有以前的事件传递有关手势的信息（即，该手势对象包含关于手势第一次运动的信息），则此属性包含零。
访问函数
| qreal | lastScaleFactor() const |
| void | setLastScaleFactor(qreal value) |
参见scaleFactor和totalScaleFactor.
rotationAngle : qreal
该属性保存了手势运动覆盖的角度
访问函数
| qreal | rotationAngle() const |
| void | setRotationAngle(qreal value) |
参见totalRotationAngle和lastRotationAngle.
scaleFactor : qreal
该属性保存了当前缩放因子
缩放因子衡量的是触摸设备上用户输入之间距离相关的缩放因子。
访问函数
| qreal | scaleFactor() const |
| void | setScaleFactor(qreal value) |
参见totalScaleFactor和lastScaleFactor.
startCenterPoint : QPointF
该属性保存了中心点的起始位置
访问函数
| QPointF | startCenterPoint() const |
| void | setStartCenterPoint(const QPointF &value) |
参见centerPoint和lastCenterPoint.
totalChangeFlags : ChangeFlags
该属性保存了手势的变化属性
该属性指示自手势开始以来哪些其他属性已经更改。您可以使用此信息来确定需要更新用户界面的哪个方面。
访问函数
| QPinchGesture::ChangeFlags | totalChangeFlags() const |
| void | setTotalChangeFlags(QPinchGesture::ChangeFlags value) |
另请参阅 changeFlags、scaleFactor、rotationAngle 和 centerPoint。
totalRotationAngle : qreal
此属性用于保存手势覆盖的总角度
此总角度测量手势完全覆盖的角度。通常，此值等于rotationAngle属性中的值，除非用户通过移除和重新定位一个触摸点执行了多次旋转，如上所述。在这种情况下，总角度将是手势多个阶段旋转角度的总和。
访问函数
| qreal | totalRotationAngle() const |
| void | setTotalRotationAngle(qreal value) |
另请参阅 rotationAngle 和 lastRotationAngle。
totalScaleFactor : qreal
此属性用于保存总缩放因子
总缩放因子测量缩放因子的总变化，从原始值到当前缩放因子。
访问函数
| qreal | totalScaleFactor() const |
| void | setTotalScaleFactor(qreal value) |
另请参阅 scaleFactor 和 lastScaleFactor。
© 2024 The Qt Company Ltd. 内部文档贡献属于各自拥有者的版权。本文档根据GNU自由文档许可证版本1.3条款发布，由免费软件基金会发布。Qt和相应的标志是The Qt Company Ltd.在芬兰和/或其他国家/地区的商标。所有其他商标均为其各自所有者的财产。
