• Home
• Qt 5.11
• Qt Quick
• QML Types
• PinchHandler QML Type

PinchHandler

Handler for pinch gestures. More...

• List of all members, including inherited members

Properties

• active : bool
• centroid : QPointF
• centroidVelocity : QVector2D
• maximumRotation : real
• maximumScale : real
• maximumX : real
• maximumY : real
• minimumRotation : real
• minimumScale : real
• minimumTouchPoints : int
• minimumX : real
• minimumY : real
• pinchOrigin : real
• rotation : real
• scale : real
• translation : QVector2D

Detailed Description

PinchHandler is a handler that interprets a multi-finger gesture to interactively rotate, zoom, and drag an Item. Like other Pointer Handlers, by default it is fully functional, and manipulates its target, which is the Item within which it is declared.

import QtQuick 2.8
import Qt.labs.handlers 1.0

Rectangle {
    width: 400
    height: 300
    color: "lightsteelblue"
    PinchHandler { }
}

It has properties to restrict the range of dragging, rotation, and zoom.

If it is declared within one Item but is assigned a different target, it handles events within the bounds of the outer Item but manipulates the target Item instead:

import QtQuick 2.8
import Qt.labs.handlers 1.0

Item {
    width: 640
    height: 480

    Rectangle {
        id: map
        color: "aqua"
        width: 400
        height: 300
    }

    PinchHandler {
        target: map
    }
}

A third way to use it is to set target to null and react to property changes in some other way:

import QtQuick 2.8
import Qt.labs.handlers 1.0

Item {
    width: 640
    height: 480

    PinchHandler {
        id: handler
        target: null
    }

    Text {
        color: handler.active ? "darkgreen" : "black"
        text: handler.rotation.toFixed(1) + " degrees\n" +
              handler.translation.x.toFixed(1) + ", " + handler.translation.y.toFixed(1) + "\n" +
              (handler.scale * 100).toFixed(1) + "%"
    }
}

See also PinchArea.

Property Documentation