QtLocation MapPinchEvent

MapPinchEvent type provides basic information about pinch event.

Import Statement: import QtLocation 5.3
Since: Qt Location 5.0

Properties

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.