Previous topic
Next topic
QPinchGesture¶
The QPinchGesture class describes a pinch gesture made by the user. More…
New in version 4.6.
Synopsis¶
Functions¶
def
centerPoint()def
changeFlags()def
lastCenterPoint()def
lastRotationAngle()def
lastScaleFactor()def
rotationAngle()def
scaleFactor()def
setCenterPoint(value)def
setChangeFlags(value)def
setLastCenterPoint(value)def
setLastRotationAngle(value)def
setLastScaleFactor(value)def
setRotationAngle(value)def
setScaleFactor(value)def
setStartCenterPoint(value)def
setTotalChangeFlags(value)def
setTotalRotationAngle(value)def
setTotalScaleFactor(value)def
startCenterPoint()def
totalChangeFlags()def
totalRotationAngle()def
totalScaleFactor()
Detailed Description¶
A pinch gesture is a form of touch user input in which the user typically touches two points on the input device with a thumb and finger, before moving them closer together or further apart to change the scale factor, zoom, or level of detail of the user interface.
For an overview of gesture handling in Qt and information on using gestures in your applications, see the Gestures in Widgets and Graphics View document.
Instead of repeatedly applying the same pinching gesture, the user may continue to touch the input device in one place, and apply a second touch to a new point, continuing the gesture. When this occurs, gesture events will continue to be delivered to the target object, containing an instance of QPinchGesture in the GestureUpdated state.
See also
- class PySide6.QtWidgets.QPinchGesture([parent=None])¶
- Parameters
parent –
PySide6.QtCore.QObject
- PySide6.QtWidgets.QPinchGesture.ChangeFlag¶
This enum describes the changes that can occur to the properties of the gesture object.
Constant
Description
QPinchGesture.ScaleFactorChanged
The scale factor held by
scaleFactorchanged.QPinchGesture.RotationAngleChanged
The rotation angle held by
rotationAnglechanged.QPinchGesture.CenterPointChanged
The center point held by
centerPointchanged.See also
- PySide6.QtWidgets.QPinchGesture.centerPoint()¶
- Return type
This property holds the current center point.
The center point is the midpoint between the two input points in the gesture.
See also
- PySide6.QtWidgets.QPinchGesture.changeFlags()¶
- Return type
ChangeFlags
See also
- PySide6.QtWidgets.QPinchGesture.lastCenterPoint()¶
- Return type
This property holds the last position of the center point recorded for this gesture.
See also
- PySide6.QtWidgets.QPinchGesture.lastRotationAngle()¶
- Return type
float
This property holds the last reported angle covered by the gesture motion.
The last rotation angle is the angle as reported in the rotationAngle property when a previous gesture event was delivered for this gesture.
See also
- PySide6.QtWidgets.QPinchGesture.lastScaleFactor()¶
- Return type
float
This property holds the last scale factor recorded for this gesture.
The last scale factor contains the scale factor reported in the scaleFactor property when a previous gesture event included information about this gesture.
If no previous event was delivered with information about this gesture (i.e., this gesture object contains information about the first movement in the gesture) then this property contains zero.
See also
- PySide6.QtWidgets.QPinchGesture.rotationAngle()¶
- Return type
float
This property holds the angle covered by the gesture motion.
See also
- PySide6.QtWidgets.QPinchGesture.scaleFactor()¶
- Return type
float
This property holds the current scale factor.
The scale factor measures the scale factor associated with the distance between two of the user’s inputs on a touch device.
See also
- PySide6.QtWidgets.QPinchGesture.setCenterPoint(value)¶
- Parameters
value –
PySide6.QtCore.QPointF
This property holds the current center point.
The center point is the midpoint between the two input points in the gesture.
See also
- PySide6.QtWidgets.QPinchGesture.setChangeFlags(value)¶
- Parameters
value –
ChangeFlags
See also
- PySide6.QtWidgets.QPinchGesture.setLastCenterPoint(value)¶
- Parameters
value –
PySide6.QtCore.QPointF
This property holds the last position of the center point recorded for this gesture.
See also
- PySide6.QtWidgets.QPinchGesture.setLastRotationAngle(value)¶
- Parameters
value – float
This property holds the last reported angle covered by the gesture motion.
The last rotation angle is the angle as reported in the rotationAngle property when a previous gesture event was delivered for this gesture.
See also
- PySide6.QtWidgets.QPinchGesture.setLastScaleFactor(value)¶
- Parameters
value – float
This property holds the last scale factor recorded for this gesture.
The last scale factor contains the scale factor reported in the scaleFactor property when a previous gesture event included information about this gesture.
If no previous event was delivered with information about this gesture (i.e., this gesture object contains information about the first movement in the gesture) then this property contains zero.
See also
- PySide6.QtWidgets.QPinchGesture.setRotationAngle(value)¶
- Parameters
value – float
This property holds the angle covered by the gesture motion.
See also
- PySide6.QtWidgets.QPinchGesture.setScaleFactor(value)¶
- Parameters
value – float
This property holds the current scale factor.
The scale factor measures the scale factor associated with the distance between two of the user’s inputs on a touch device.
See also
- PySide6.QtWidgets.QPinchGesture.setStartCenterPoint(value)¶
- Parameters
value –
PySide6.QtCore.QPointF
This property holds the starting position of the center point.
See also
- PySide6.QtWidgets.QPinchGesture.setTotalChangeFlags(value)¶
- Parameters
value –
ChangeFlags
See also
- PySide6.QtWidgets.QPinchGesture.setTotalRotationAngle(value)¶
- Parameters
value – float
This property holds the total angle covered by the gesture.
This total angle measures the complete angle covered by the gesture. Usually, this is equal to the value held by the rotationAngle property, except in the case where the user performs multiple rotations by removing and repositioning one of the touch points, as described above. In this case, the total angle will be the sum of the rotation angles for the multiple stages of the gesture.
See also
- PySide6.QtWidgets.QPinchGesture.setTotalScaleFactor(value)¶
- Parameters
value – float
This property holds the total scale factor.
The total scale factor measures the total change in scale factor from the original value to the current scale factor.
See also
- PySide6.QtWidgets.QPinchGesture.startCenterPoint()¶
- Return type
This property holds the starting position of the center point.
See also
- PySide6.QtWidgets.QPinchGesture.totalChangeFlags()¶
- Return type
ChangeFlags
See also
- PySide6.QtWidgets.QPinchGesture.totalRotationAngle()¶
- Return type
float
This property holds the total angle covered by the gesture.
This total angle measures the complete angle covered by the gesture. Usually, this is equal to the value held by the rotationAngle property, except in the case where the user performs multiple rotations by removing and repositioning one of the touch points, as described above. In this case, the total angle will be the sum of the rotation angles for the multiple stages of the gesture.
See also
- PySide6.QtWidgets.QPinchGesture.totalScaleFactor()¶
- Return type
float
This property holds the total scale factor.
The total scale factor measures the total change in scale factor from the original value to the current scale factor.
See also
© 2022 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.