PinchEvent QML Type | Qt Quick (original) (raw)

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 : point [read-only]
previousCenter : point [read-only]
startCenter : point [read-only]

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

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.

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.

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

point1 : point [read-only]
point2 : point [read-only]
startPoint1 : point [read-only]
startPoint2 : point [read-only]

These properties provide the actual touch points generating the pinch.

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.

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