MapPinchEvent QML Type | Qt Location 5.5

- Qt 5.5
- Qt Location
- QML Types
- MapPinchEvent QML Type
- Qt 5.5.1 Reference Documentation

# MapPinchEvent QML Type

MapPinchEvent type provides basic information about pinch event. More...

Import Statement: | import QtLocation 5.3
Since: | Qt Location 5.0

- List of all members, including inherited members

## Properties

- accepted : bool
- angle : real
- center : QPoint
- point1 : QPoint
- point2 : QPoint
- pointCount : int

## Detailed Description

MapPinchEvent type provides basic information about pinch event. They are present in handlers of MapPinch (for example pinchStarted/pinchUpdated). Events are only guaranteed to be valid for the duration of the handler.

Except for the accepted property, all properties are read-only.

### Example Usage

The following example enables the pinch gesture on a map and reacts to the finished event.

    Map {
        id: map
        gesture.enabled: true
        gesture.onPinchFinished:{
            var coordinate1 = map.toCoordinate(gesture.point1)
            var coordinate2 = map.toCoordinate(gesture.point2)
            console.log("Pinch started at:")
            console.log("        Points (" + gesture.point1.x + ", " + gesture.point1.y + ") - (" + gesture.point2.x + ", " + gesture.point2.y + ")")
            console.log("   Coordinates (" + coordinate1.latitude + ", " + coordinate1.longitude + ") - (" + coordinate2.latitude + ", " + coordinate2.longitude + ")")
        }
    }

## Property Documentation

accepted : bool

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

angle : real

This read-only property holds the current angle between the two points in the range -180 to 180. Positive values for the angles mean counter-clockwise while negative values mean the clockwise direction. Zero degrees is at the 3 o'clock position.

center : QPoint

This read-only property holds the current center point.

point1 : QPoint

These read-only properties hold the actual touch points generating the pinch. The points are not in any particular order.

point2 : QPoint

These read-only properties hold the actual touch points generating the pinch. The points are not in any particular order.

pointCount : int

This read-only property holds the number of points currently touched. The MapPinch will not react until two touch points have initiated a gesture, but will remain active until all touch points have been released.