Back to Qt.io
Contact Us Blog Download Qt

PinchEvent QML Type

For specifying information about a pinch event. More...

Import Statement: import QtQuick

Properties

Detailed Description

The PinchEvent type was added in QtQuick 1.1

The center, startCenter, previousCenter properties provide the center position between the two touch points.

The scale and previousScale properties provide the scale factor.

The angle, previousAngle and rotation properties provide the angle between the two points and the amount of rotation.

The point1, point2, startPoint1, startPoint2 properties provide the positions of the touch points.

The accepted property may be set to false in the onPinchStarted handler if the gesture should not be handled.

See also PinchArea.

Property Documentation

center : QPointF [read-only]

previousCenter : QPointF [read-only]

startCenter : QPointF [read-only]

These properties hold the position of the center point between the two touch points.

  • center is the current center point
  • previousCenter is the center point of the previous event.
  • startCenter is the center point when the gesture began

previousScale : real [read-only]

scale : real [read-only]

These properties hold the scale factor determined by the change in distance between the two touch points.

  • scale is the current scale factor.
  • previousScale is the scale factor of the previous event.

When a pinch gesture is started, the scale is 1.0.


angle : real [read-only]

previousAngle : real [read-only]

rotation : real [read-only]

These properties hold the angle between the two touch points.

  • angle is the current angle between the two points in the range -180 to 180.
  • previousAngle is the angle of the previous event.
  • rotation is the total rotation since the pinch gesture started.

When a pinch gesture is started, the rotation is 0.0.


point1 : QPointF [read-only]

point2 : QPointF [read-only]

startPoint1 : QPointF [read-only]

startPoint2 : QPointF [read-only]

These properties provide the actual touch points generating the pinch.

  • point1 and point2 hold the current positions of the points.
  • startPoint1 and startPoint2 hold the positions of the points when the second point was touched.

accepted : bool

Setting this property to false in the PinchArea::onPinchStarted handler will result in no further pinch events being generated, and the gesture ignored.


pointCount : int [read-only]

Holds the number of points currently touched. The PinchArea will not react until two touch points have initited a gesture, but will remain active until all touch points have been released.


© 2024 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.