Qt Reference Documentation

- Qt 4.8
- ALL VERSIONS

- A
- A
- A
- Print

# QML PinchEvent Element

The PinchEvent object provides information about a pinch event. More...

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

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 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 center : QPointF
read-only startCenter : QPointF
read-only previousCenter : 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 point1 : QPointF
read-only startPoint1 : QPointF
read-only point2 : 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.

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.

read-only scale : real
read-only previousScale : 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.