- Qt 6.6
- Qt Quick
- QML Types
- PinchEvent
- Qt 6.6.1 Reference Documentation

# PinchEvent QML Type

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

Import Statement: | import QtQuick

- List of all members, including inherited members

## Properties

- accepted : bool
- angle : real
- center : QPointF
- point1 : QPointF
- point2 : QPointF
- pointCount : int
- previousAngle : real
- previousCenter : QPointF
- previousScale : real
- rotation : real
- scale : real
- startCenter : QPointF
- startPoint1 : QPointF
- startPoint2 : QPointF

## 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

[read-only] center : QPointF
[read-only] previousCenter : QPointF
[read-only] startCenter : QPointF

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

[read-only] previousScale : real
[read-only] scale : real

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`.

[read-only] angle : real
[read-only] previousAngle : real
[read-only] rotation : real

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`.

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

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.

[read-only] pointCount : int

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.