class QPinchGesture

《a class="reference internal" href="#PySide6.QtWidgets.QPinchGesture" title="PySide6.QtWidgets.QPinchGesture">QPinchGesture》类描述用户所做出的捏合手势。 更多...

新增于版本4.6。

概述

属性

• centerPointŢ - 当前中心点

• changeFlagsŢ - 在当前步骤中发生变化的捏合手势属性

• lastCenterPointŢ - 为此次捏合手势记录的最后位置的中心点

• lastRotationAngleŢ - 由捏合手势动作覆盖的最后报告的角

• lastScaleFactorŢ - 为此次捏合手势记录的最后比例因子

• rotationAngleŢ - 由捏合手势动作覆盖的角度

• scaleFactorŢ - 当前比例因子

• startCenterPointᅟ - 中心点的起始位置

• totalChangeFlagsᅟ - 改变的手势属性

• totalRotationAngleᅟ - 手势覆盖的总角度

• totalScaleFactorᅟ - 总缩放因子

方法

• def __init__()

• def centerPoint()

• def changeFlags()

• def lastCenterPoint()

• def lastRotationAngle()

• def lastScaleFactor()

• def rotationAngle()

• def scaleFactor()

• def setCenterPoint()

• def setChangeFlags()

• def setLastCenterPoint()

• def setLastRotationAngle()

• def setLastScaleFactor()

• def setRotationAngle()

• def setScaleFactor()

• def setStartCenterPoint()

• def setTotalChangeFlags()

• def setTotalRotationAngle()

• def setTotalScaleFactor()

• def startCenterPoint()

• def totalChangeFlags()

• def totalRotationAngle()

• def totalScaleFactor()

注意：

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

详细描述

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

有关Qt中手势处理和如何在应用程序中使用手势的概述，请参阅widgets和Graphics View中的手势文档。

用户可以通过在一个地方继续触摸输入设备，并将第二次触摸应用到新的点来继续捏合手势，而不是反复应用相同的手势。在这种情况下，手势事件会继续传递到目标对象，其中包含一个处于Qt::GestureUpdated状态的QPinchGesture实例。

另见：

QPanGesture QSwipeGesture

class ChangeFlag

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

常量	描述
QPinchGesture.ScaleFactorChanged	scaleFactor保持的缩放因子已更改。
QPinchGesture.RotationAngleChanged	rotationAngle保持的旋转角度已更改。
QPinchGesture.CenterPointChanged	centerPoint保持的中心点已更改。

另见：

changeFlags totalChangeFlags

注意：

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

属性centerPoint: QPointF

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

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

另见：

startCenterPoint lastCenterPoint

访问函数

• centerPoint()

• setCenterPoint()

属性changeFlags: QGraphicsEffect.ChangeFlag 的组合

该属性保存了当前步骤中发生变化的属性。

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

另见：

totalChangeFlags scaleFactor rotationAngle centerPoint

访问函数

• changeFlags()

• setChangeFlags()

属性lastCenterPoint: QPointF

该属性保存了此手势记录的最后中心点位置。

另见：

centerPoint startCenterPoint

访问函数

• lastCenterPoint()

• setLastCenterPoint()

属性lastRotationAngle: float

该属性保存了手势动作所覆盖的最后一个报告角度。

最后的旋转角度是当为该手势传递上一个手势事件时，rotationAngle 属性报告的角度。

另见：

rotationAngle totalRotationAngle

访问函数

• lastRotationAngle()

• setLastRotationAngle()

属性 lastScaleFactor： float

此属性保存了该手势记录的最后缩放因子。

在包含有关此手势信息的先前手势事件中报告的最后缩放因子包含在此缩放因子中。

如果没有传递有关此手势的信息的先前事件（即，此手势对象包含有关手势第一次移动的信息），则此属性包含零。

另见：

scaleFactor totalScaleFactor

访问函数

• lastScaleFactor()

• setLastScaleFactor()

属性 rotationAngle： float

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

另见：

totalRotationAngle lastRotationAngle

访问函数

• rotationAngle()

• setRotationAngle()

属性 scaleFactor： float

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

缩放因子衡量触摸设备上用户输入之间距离相关的缩放因子。

另见：

totalScaleFactor lastScaleFactor

访问函数

• scaleFactor()

• setScaleFactor()

属性 startCenterPoint： QPointF

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

另见：

centerPoint lastCenterPoint

访问函数

• startCenterPoint()

• setStartCenterPoint()

属性 totalChangeFlags： QGraphicsEffect.ChangeFlag 的组合

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

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

另见：

changeFlags scaleFactor rotationAngle centerPoint

访问函数

• totalChangeFlags()

• setTotalChangeFlags()

property totalRotationAngleᅟ: float

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

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

另见：

rotationAngle lastRotationAngle

访问函数

• totalRotationAngle()

• setTotalRotationAngle()

property totalScaleFactorᅟ: float

此属性保存总缩放因子。

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

另见：

scaleFactor lastScaleFactor

访问函数

• totalScaleFactor()

• setTotalScaleFactor()

__init__([parent=None])

参数:

parent – QObject

centerPoint()

返回类型:

QPointF

另见：

setCenterPoint()

该属性的获取器 centerPointᅟ .

changeFlags()

返回类型:

组合了ChangeFlag

另见：

setChangeFlags()

lastCenterPoint()

返回类型:

QPointF

另见：

setLastCenterPoint()

属性 lastCenterPoint 的获取器。

lastRotationAngle()

返回类型:

float类型

另见：

setLastRotationAngle()

属性 lastRotationAngle 的获取器。

lastScaleFactor()

返回类型:

float类型

另见：

setLastScaleFactor()

属性 lastScaleFactor 的获取器。

rotationAngle()

返回类型:

float类型

另见：

setRotationAngle()

属性 rotationAngle 的获取器。

scaleFactor()

返回类型:

float类型

另见：

setScaleFactor()

属性 scaleFactor 的获取器。

setCenterPoint(value)

参数:

value – QPointF

另见：

centerPoint()

属性 centerPoint 的设置器。

setChangeFlags(value)

参数:

value – 组合了ChangeFlag

另见：

changeFlags()

setLastCenterPoint(value)

参数:

value – QPointF

另见：

lastCenterPoint()

属性 lastCenterPoint 的设置器。

setLastRotationAngle(value)

参数:

value – float

另见：

lastRotationAngle()

属性 lastRotationAngle 的设置器。

setLastScaleFactor(value)

参数:

value – float

另见：

lastScaleFactor()

属性 lastScaleFactor 的设置器。

setRotationAngle(value)

参数:

value – float

另见：

rotationAngle()

属性 rotationAngle 的设置器。

setScaleFactor(value)

参数:

value – float

另见：

scaleFactor()

属性 scaleFactor 的设置器。

setStartCenterPoint(value)

参数:

value – QPointF

另见：

startCenterPoint()

属性 startCenterPoint 的设置器。

setTotalChangeFlags(value)

参数:

value – 组合了ChangeFlag

另见：

totalChangeFlags()

setTotalRotationAngle(value)

参数:

value – float

另见：

totalRotationAngle()

属性 totalRotationAngle 的设置器。

setTotalScaleFactor(value)

参数:

value – float

另见：

totalScaleFactor()

属性 totalScaleFactor 的设置器。

startCenterPoint()

返回类型:

QPointF

另见：

setStartCenterPoint()

属性 startCenterPoint 的获取器。

totalChangeFlags()

返回类型:

组合了ChangeFlag

另见：

setTotalChangeFlags()

totalRotationAngle()

返回类型:

float类型

另见：

setTotalRotationAngle()

属性 totalRotationAngle 的获取器。

totalScaleFactor()

返回类型:

float类型

另见：

setTotalScaleFactor()

属性 totalScaleFactor 的获取器。