PySide6.QtWidgets.QPinchGesture

class QPinchGesture

QPinchGesture 类描述了用户做出的捏合手势。更多

PySide6.QtWidgets.QPinchGesture 的继承图

在版本4.6中添加。

概要

属性

方法

注意

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

详细描述

捏合手势是一种触摸用户输入形式,用户通常用拇指和手指触摸输入设备上的两个点,然后将它们靠近或分开以改变用户界面的比例因子、缩放或细节级别。

有关Qt中手势处理的概述以及如何在您的应用程序中使用手势的信息,请参阅Gestures in Widgets and Graphics View文档。

../../_images/pinchgesture.png

用户无需重复应用相同的捏合手势,而是可以继续在一个地方触摸输入设备,并在新的点上应用第二次触摸,以继续手势。当这种情况发生时,手势事件将继续传递给目标对象,其中包含处于Qt::GestureUpdated状态的QPinchGesture实例。

另请参阅

QPanGesture QSwipeGesture

class ChangeFlag

(继承自 enum.Flag) 此枚举描述了手势对象属性可能发生的变化。

常量

描述

QPinchGesture.ScaleFactorChanged

scaleFactor持有的缩放因子已更改。

QPinchGesture.RotationAngleChanged

rotationAngle持有的旋转角度已更改。

QPinchGesture.CenterPointChanged

centerPoint保持的中心点已更改。

注意

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

property centerPointᅟ: QPointF

此属性保存当前的中心点。

中心点是手势中两个输入点之间的中点。

Access functions:
property changeFlagsᅟ: Combination of QGraphicsEffect.ChangeFlag

此属性保存当前步骤中已更改的手势属性。

此属性指示自上一个手势事件以来,哪些其他属性发生了变化,该事件包含了关于此手势的信息。您可以使用此信息来确定用户界面的哪个方面需要更新。

Access functions:
property lastCenterPointᅟ: QPointF

此属性保存为此手势记录的最后一个中心点的位置。

Access functions:
property lastRotationAngleᅟ: float

此属性保存手势运动覆盖的最后一个报告的角度。

最后一个旋转角度是在为此手势传递前一个手势事件时,在rotationAngle属性中报告的角度。

Access functions:
property lastScaleFactorᅟ: float

此属性保存为此手势记录的最后一个比例因子。

最后一个比例因子包含在前一个手势事件中包含有关此手势信息时报告的scaleFactor属性中的比例因子。

如果没有先前的事件传递了关于此手势的信息(即,此手势对象包含有关手势中第一个移动的信息),则此属性包含零。

Access functions:
property rotationAngleᅟ: float

此属性保存手势运动所覆盖的角度。

Access functions:
property scaleFactorᅟ: float

此属性保存当前的缩放因子。

比例因子测量与用户在触摸设备上两次输入之间的距离相关的比例因子。

Access functions:
property startCenterPointᅟ: QPointF

此属性保存中心点的起始位置。

Access functions:
property totalChangeFlagsᅟ: Combination of QGraphicsEffect.ChangeFlag

此属性保存已更改手势的属性。

此属性指示自手势开始以来其他属性中哪个已更改。您可以使用此信息来确定用户界面的哪个方面需要更新。

Access functions:
property totalRotationAngleᅟ: float

此属性保存手势覆盖的总角度。

这个总角度测量了手势覆盖的完整角度。通常,这等于rotationAngle属性所持有的值,除非用户通过移除并重新定位其中一个触摸点来执行多次旋转,如上所述。在这种情况下,总角度将是手势多个阶段的旋转角度之和。

Access functions:
property totalScaleFactorᅟ: float

此属性保存总比例因子。

总比例因子测量从原始值到当前比例因子的总变化。

Access functions:
__init__([parent=None])
Parameters:

父对象QObject

centerPoint()
Return type:

QPointF

另请参阅

setCenterPoint()

属性 centerPointᅟ 的获取器。

changeFlags()
Return type:

ChangeFlag的组合

另请参阅

setChangeFlags()

lastCenterPoint()
Return type:

QPointF

另请参阅

setLastCenterPoint()

属性 lastCenterPointᅟ 的获取器。

lastRotationAngle()
Return type:

浮点数

另请参阅

setLastRotationAngle()

属性 lastRotationAngleᅟ 的获取器。

lastScaleFactor()
Return type:

浮点数

另请参阅

setLastScaleFactor()

属性 lastScaleFactorᅟ 的获取器。

rotationAngle()
Return type:

浮点数

另请参阅

setRotationAngle()

属性 rotationAngleᅟ 的获取器。

scaleFactor()
Return type:

浮点数

另请参阅

setScaleFactor()

属性 scaleFactorᅟ 的获取器。

setCenterPoint(value)
Parameters:

QPointF

另请参阅

centerPoint()

属性 centerPointᅟ 的设置器。

setChangeFlags(value)
Parameters:

valueChangeFlag 的组合

另请参阅

changeFlags()

setLastCenterPoint(value)
Parameters:

QPointF

另请参阅

lastCenterPoint()

属性 lastCenterPointᅟ 的设置器。

setLastRotationAngle(value)
Parameters:

value – 浮点数

另请参阅

lastRotationAngle()

属性 lastRotationAngleᅟ 的设置器。

setLastScaleFactor(value)
Parameters:

value – 浮点数

另请参阅

lastScaleFactor()

属性 lastScaleFactorᅟ 的设置器。

setRotationAngle(value)
Parameters:

value – 浮点数

另请参阅

rotationAngle()

属性 rotationAngleᅟ 的设置器。

setScaleFactor(value)
Parameters:

value – 浮点数

另请参阅

scaleFactor()

属性 scaleFactorᅟ 的设置器。

setStartCenterPoint(value)
Parameters:

QPointF

另请参阅

startCenterPoint()

属性 startCenterPointᅟ 的设置器。

setTotalChangeFlags(value)
Parameters:

valueChangeFlag 的组合

另请参阅

totalChangeFlags()

setTotalRotationAngle(value)
Parameters:

value – 浮点数

另请参阅

totalRotationAngle()

属性 totalRotationAngleᅟ 的设置器。

setTotalScaleFactor(value)
Parameters:

value – 浮点数

另请参阅

totalScaleFactor()

属性 totalScaleFactorᅟ 的设置器。

startCenterPoint()
Return type:

QPointF

另请参阅

setStartCenterPoint()

属性 startCenterPointᅟ 的获取器。

totalChangeFlags()
Return type:

ChangeFlag的组合

另请参阅

setTotalChangeFlags()

totalRotationAngle()
Return type:

浮点数

属性 totalRotationAngleᅟ 的获取器。

totalScaleFactor()
Return type:

浮点数

另请参阅

setTotalScaleFactor()

属性 totalScaleFactorᅟ 的获取器。