PinchHandler QML Type

Die Typen von Zeigegeräten, die diesen Pointer-Handler aktivieren können.

Standardmäßig ist diese Eigenschaft auf PointerDevice.AllDevices gesetzt. Wenn Sie sie auf eine ODER-Kombination von Gerätetypen setzen, werden Ereignisse von nicht übereinstimmenden Geräten ignoriert.

So kann ein Steuerelement beispielsweise mit zwei Handlern auf Maus- und Stiftklicks und auf Berührungen des Touchscreens reagieren:

Item {
   TapHandler {
       acceptedDevices: PointerDevice.Mouse | PointerDevice.TouchPad | PointerDevice.Stylus
       onTapped: console.log("clicked")
   }
   TapHandler {
       acceptedDevices: PointerDevice.TouchScreen
       onTapped: console.log("tapped")
   }
}

Wenn diese Eigenschaft gesetzt ist, müssen die angegebenen Tastaturmodifikatoren gedrückt werden, um auf Zeigerereignisse zu reagieren, andernfalls werden sie ignoriert.

Wenn diese Eigenschaft auf Qt.KeyboardModifierMask (den Standardwert) gesetzt ist, ignoriert PointerHandler die Modifizierungstasten.

Ein Item könnte zum Beispiel zwei Handler desselben Typs haben, von denen einer nur aktiviert wird, wenn die erforderlichen Tastaturmodifikatoren gedrückt werden:

Item {
   TapHandler {
       acceptedModifiers: Qt.ControlModifier
       onTapped: console.log("control-tapped")
   }
   TapHandler {
       acceptedModifiers: Qt.NoModifier
       onTapped: console.log("tapped")
   }
}

Wenn Sie acceptedModifiers auf eine ODER-Kombination von Modifikatortasten setzen, bedeutet dies, dass alle diese Modifikatoren gedrückt werden müssen, um den Handler zu aktivieren:

Item {
   TapHandler {
       acceptedModifiers: Qt.ControlModifier | Qt.AltModifier | Qt.ShiftModifier
       onTapped: console.log("control-alt-shift-tapped")
   }
}

Die verfügbaren Modifikatoren sind wie folgt:

Wenn Sie ein noch komplexeres Verhalten benötigen, als es mit Kombinationen mehrerer Handler mit mehreren Modifier-Flags erreicht werden kann, können Sie die Modifier in JavaScript-Code überprüfen:

Item {
    TapHandler {
        onTapped:
            switch (point.modifiers) {
            case Qt.ControlModifier | Qt.AltModifier:
                console.log("CTRL+ALT");
                break;
            case Qt.ControlModifier | Qt.AltModifier | Qt.MetaModifier:
                console.log("CTRL+META+ALT");
                break;
            default:
                console.log("other modifiers", point.modifiers);
                break;
            }
    }
}

Siehe auch Qt::KeyboardModifier.

Die Arten von Zeigeinstrumenten (Finger, Stift, Radiergummi usw.), die diesen Pointer-Handler aktivieren können.

Standardmäßig ist diese Eigenschaft auf PointerDevice.AllPointerTypes gesetzt. Wenn Sie sie auf eine ODER-Kombination von Gerätetypen setzen, werden Ereignisse von nicht übereinstimmenden devices ignoriert.

Beispielsweise könnte ein Steuerelement so eingerichtet werden, dass es auf Maus-, Touch- und Stiftklicks reagiert, sich aber selbst löscht, wenn es mit einem Radiergummi auf einem Grafiktablett angetippt wird, und zwar mit zwei Handlern:

Rectangle {
   id: rect
   TapHandler {
       acceptedPointerTypes: PointerDevice.Generic | PointerDevice.Finger | PointerDevice.Pen
       onTapped: console.log("clicked")
   }
   TapHandler {
       acceptedPointerTypes: PointerDevice.Eraser
       onTapped: rect.destroy()
   }
}

Diese Eigenschaft ist true, wenn alle Beschränkungen (insbesondere minimumPointCount und maximumPointCount) erfüllt sind und das Ziel, falls vorhanden, manipuliert wird.

Die Drehung der Pinch-Geste in Grad, mit positiven Werten im Uhrzeigersinn. Sie lautet 0, wenn die Geste beginnt. Wenn target nicht null ist, wird dies automatisch zu rotation hinzugefügt. Andernfalls können Bindungen verwendet werden, um beliebige Dinge mit diesem Wert zu tun.

Siehe auch QtQuick::PinchHandler::rotationAxis.activeValue.

Der Skalierungsfaktor, während die Pinch-Geste ausgeführt wird. Er beträgt zu Beginn der Geste 1,0, erhöht sich, wenn die Berührungspunkte auseinandergezogen werden, und verringert sich, wenn die Berührungspunkte zusammengeführt werden. Wenn target nicht null ist, wird scale automatisch mit diesem Wert multipliziert. Ansonsten können Bindungen verwendet werden, um beliebige Dinge mit diesem Wert zu tun.

Siehe auch QtQuick::PinchHandler::scaleAxis.activeValue.

Die Verschiebung des Punktclusters, während die Pinch-Geste ausgeführt wird. Sie lautet 0, 0, wenn die Geste beginnt, und erhöht sich, wenn eventPoint(s) nach unten und nach rechts gezogen wird. Nach Beendigung der Geste bleibt der Wert unverändert und wird bei Beginn der nächsten Pinch-Geste wieder auf 0, 0 zurückgesetzt.

Ein Punkt, der genau in der Mitte der aktuell gedrückten Berührungspunkte liegt. Das Ziel wird um diesen Punkt gedreht.

Diese Eigenschaft enthält die Cursorform, die angezeigt wird, wenn die Maus über dem Element parent schwebt, während active true ist.

Die verfügbaren Cursorformen sind:

• Qt.ArrowCursor
• Qt.UpArrowCursor
• Qt.CrossCursor
• Qt.WaitCursor
• Qt.IBeamCursor
• Qt.SizeVerCursor
• Qt.SizeHorCursor
• Qt.SizeBDiagCursor
• Qt.SizeFDiagCursor
• Qt.SizeAllCursor
• Qt.BlankCursor
• Qt.SplitVCursor
• Qt.SplitHCursor
• Qt.PointingHandCursor
• Qt.ForbiddenCursor
• Qt.WhatsThisCursor
• Qt.BusyCursor
• Qt.OpenHandCursor
• Qt.ClosedHandCursor
• Qt.DragCopyCursor
• Qt.DragMoveCursor
• Qt.DragLinkCursor

Der Standardwert ist nicht gesetzt, so dass das Element cursor von parent erscheinen kann. Diese Eigenschaft kann auf den gleichen Ausgangszustand zurückgesetzt werden, indem sie auf undefiniert gesetzt wird.

Siehe auch Qt::CursorShape, QQuickItem::cursor(), und HoverHandler::cursorShape.

Die Entfernung in Pixeln, die der Benutzer eine eventPoint ziehen muss, damit sie als Ziehgeste behandelt wird.

Der Standardwert hängt von der Plattform und der Bildschirmauflösung ab. Er kann auf den Standardwert zurückgesetzt werden, indem er auf undefiniert gesetzt wird. Das Verhalten, wenn eine Ziehgeste beginnt, variiert in verschiedenen Handlern.

Wenn ein PointerHandler deaktiviert ist, werden alle Ereignisse zurückgewiesen und keine Signale ausgegeben.

Diese Eigenschaft legt die Berechtigungen fest, wenn die Logik dieses Handlers beschließt, den exklusiven Greifvorgang zu übernehmen, oder wenn er von einem anderen Handler aufgefordert wird, die Übernahme oder den Abbruch des Greifvorgangs zu genehmigen.

Die Voreinstellung ist PointerHandler.CanTakeOverFromItems | PointerHandler.CanTakeOverFromHandlersOfDifferentType | PointerHandler.ApprovesTakeOverByAnything, was die meisten Übernahmeszenarien erlaubt, aber z.B. verhindert, dass zwei PinchHandler um dieselben Touchpoints kämpfen.

Der Spielraum außerhalb der Grenzen des parent Elements, innerhalb dessen ein eventPoint diesen Handler aktivieren kann. Bei einem PinchHandler, bei dem target auch das parent ist, ist es zum Beispiel sinnvoll, diesen Abstand auf mindestens die halbe Breite des Fingers eines typischen Benutzers festzulegen, damit die Pinch-Geste auch dann noch möglich ist, wenn das parent auf eine sehr kleine Größe verkleinert wurde. Wenn eine TapHandler-basierte Schaltfläche in der Nähe des Bildschirmrands platziert wird, kann sie verwendet werden, um dem Fitts'schen Gesetz zu entsprechen: Sie reagiert auf Mausklicks am Bildschirmrand, obwohl die Schaltfläche visuell einige Pixel vom Rand entfernt ist.

Der Standardwert ist 0.

Die Item, die den Anwendungsbereich des Handlers darstellt; das Element, in dem er deklariert wurde. Der Handler behandelt Ereignisse im Namen dieses Elements, was bedeutet, dass ein Zeiger-Ereignis relevant ist, wenn mindestens eines seiner eventPoints im Inneren des Elements auftritt. Ursprünglich ist target() derselbe, aber er kann neu zugewiesen werden.

Siehe auch target und QObject::parent().

Die auf das Ziel anzuwendende Drehung, wenn sie nicht null ist. Ansonsten können Bindungen verwendet werden, um beliebige Dinge mit diesem Wert zu tun. Während die Pinch-Geste ausgeführt wird, wird activeRotation kontinuierlich hinzugefügt; nach Beendigung der Geste bleibt sie gleich; und wenn die nächste Pinch-Geste beginnt, wird sie wieder durch activeRotation verändert.

Es ist möglich, diese Eigenschaft zu setzen, um die Basisrotation mit einer Rotation zu synchronisieren, die auf andere Weise gesetzt wurde, zum Beispiel durch einen anderen Handler. Wenn Sie diese Eigenschaft direkt setzen, ändert sich activeRotation nicht, und rotationChanged(0) wird ausgegeben.

Der Skalierungsfaktor, der automatisch auf das Ziel gesetzt wird, wenn er nicht null ist. Andernfalls können Bindungen verwendet werden, um beliebige Dinge mit diesem Wert zu tun. Während die Pinch-Geste ausgeführt wird, wird sie kontinuierlich mit activeScale multipliziert; nach dem Ende der Geste bleibt sie gleich; und wenn die nächste Pinch-Geste beginnt, beginnt sie wieder mit activeScale multipliziert zu werden.

Es ist möglich, diese Eigenschaft zu setzen, um die Basisskala mit einer Skala zu synchronisieren, die auf andere Weise gesetzt wurde, zum Beispiel durch einen anderen Handler. Wenn Sie diese Eigenschaft direkt setzen, ändert sich activeScale nicht, und scaleChanged(1) wird ausgegeben.

Die auf das Ziel anzuwendende Übersetzung, wenn sie nicht null ist. Ansonsten können Bindungen verwendet werden, um beliebige Dinge mit diesem Wert zu tun. Während die Pinch-Geste ausgeführt wird, wird activeTranslation kontinuierlich hinzugefügt; nach Beendigung der Geste bleibt der Wert unverändert.

Es ist möglich, diese Eigenschaft zu setzen, um die Basisübersetzung mit einer Übersetzung zu synchronisieren, die auf andere Weise gesetzt wurde, zum Beispiel durch einen anderen Handler. Wenn Sie diese Eigenschaft direkt setzen, ändert sich activeTranslation nicht, und translationChanged({0, 0}) wird ausgegeben.

rotationAxis steuert die Einschränkungen für die Einstellung der rotation des Zielelements entsprechend der Drehung der Gruppe von Berührungspunkten.

minimum ist die minimal zulässige Drehung. maximum ist die maximal zulässige Drehung. Wenn enabled wahr ist, ist die Drehung erlaubt. activeValue ist das Gleiche wie QtQuick::PinchHandler::activeRotation.

Das Signal activeValueChanged wird ausgegeben, wenn sich activeValue ändert, um die Schrittweite anzugeben, um die es sich geändert hat. Dies ist für die schrittweise Anpassung einer Eigenschaft über mehrere Handler gedacht.

import QtQuick

Rectangle {
    width: 100; height: 100
    color: "lightsteelblue"; antialiasing: true

    PinchHandler {
        id: handler
        target: null
        xAxis.onActiveValueChanged: (delta) => parent.radius -= delta
        yAxis.onActiveValueChanged: (delta) => parent.border.width += delta
        rotationAxis.onActiveValueChanged: (delta) => parent.rotation += delta // add
        scaleAxis.onActiveValueChanged: (delta) => parent.scale *= delta // multiply
    }

    WheelHandler {
        acceptedModifiers: Qt.NoModifier
        property: "rotation"
    }

    WheelHandler {
        acceptedModifiers: Qt.ControlModifier
        property: "scale"
    }
}

scaleAxis steuert die Bedingungen für die Einstellung der scale des Zielobjekts in Abhängigkeit vom Abstand zwischen den Berührungspunkten.

minimum ist die minimal akzeptable Skalierung. maximum ist die maximal akzeptable Skalierung. Wenn enabled wahr ist, ist die Skalierung erlaubt. activeValue ist dasselbe wie QtQuick::PinchHandler::activeScale.

Das Signal activeValueChanged wird ausgegeben, wenn sich activeValue ändert, um den Multiplikator für die schrittweise Änderung bereitzustellen. Dies ist für die inkrementelle Anpassung einer Eigenschaft über mehrere Handler gedacht.

import QtQuick

Rectangle {
    width: 100; height: 100
    color: "lightsteelblue"; antialiasing: true

    PinchHandler {
        id: handler
        target: null
        xAxis.onActiveValueChanged: (delta) => parent.radius -= delta
        yAxis.onActiveValueChanged: (delta) => parent.border.width += delta
        rotationAxis.onActiveValueChanged: (delta) => parent.rotation += delta // add
        scaleAxis.onActiveValueChanged: (delta) => parent.scale *= delta // multiply
    }

    WheelHandler {
        acceptedModifiers: Qt.NoModifier
        property: "rotation"
    }

    WheelHandler {
        acceptedModifiers: Qt.ControlModifier
        property: "scale"
    }
}

Das Element, das von diesem Handler bearbeitet werden soll.

Standardmäßig ist es dasselbe wie parent, das Element, innerhalb dessen der Handler deklariert ist. Es kann jedoch manchmal nützlich sein, das Ziel auf ein anderes Element zu setzen, um Ereignisse innerhalb eines Elements zu behandeln, aber ein anderes zu manipulieren; oder auf null, um das Standardverhalten zu deaktivieren und stattdessen etwas anderes zu tun.

xAxis steuert die Beschränkungen für die horizontale Verschiebung des Zielelements.

minimum ist die minimal zulässige x-Koordinate der Verschiebung. maximum ist die maximal zulässige x-Koordinate der Verschiebung. Wenn enabled wahr ist, ist das horizontale Ziehen erlaubt.

Das Signal activeValueChanged wird ausgegeben, wenn sich activeValue ändert, um die Schrittweite anzugeben, um die es sich geändert hat. Dies ist für die schrittweise Anpassung einer Eigenschaft über mehrere Handler gedacht.

import QtQuick

Rectangle {
    width: 100; height: 100
    color: "lightsteelblue"; antialiasing: true

    PinchHandler {
        id: handler
        target: null
        xAxis.onActiveValueChanged: (delta) => parent.radius -= delta
        yAxis.onActiveValueChanged: (delta) => parent.border.width += delta
        rotationAxis.onActiveValueChanged: (delta) => parent.rotation += delta // add
        scaleAxis.onActiveValueChanged: (delta) => parent.scale *= delta // multiply
    }

    WheelHandler {
        acceptedModifiers: Qt.NoModifier
        property: "rotation"
    }

    WheelHandler {
        acceptedModifiers: Qt.ControlModifier
        property: "scale"
    }
}

yAxis steuert die Beschränkungen für die vertikale Verschiebung des Zielelements.

minimum ist die minimal zulässige y-Koordinate der Verschiebung. maximum ist die maximal zulässige y-Koordinate der Verschiebung. Wenn enabled wahr ist, ist das vertikale Ziehen erlaubt.

Das Signal activeValueChanged wird ausgegeben, wenn sich activeValue ändert, um die Schrittweite anzugeben, um die es sich geändert hat. Dies ist für die schrittweise Anpassung einer Eigenschaft über mehrere Handler gedacht.

import QtQuick

Rectangle {
    width: 100; height: 100
    color: "lightsteelblue"; antialiasing: true

    PinchHandler {
        id: handler
        target: null
        xAxis.onActiveValueChanged: (delta) => parent.radius -= delta
        yAxis.onActiveValueChanged: (delta) => parent.border.width += delta
        rotationAxis.onActiveValueChanged: (delta) => parent.rotation += delta // add
        scaleAxis.onActiveValueChanged: (delta) => parent.scale *= delta // multiply
    }

    WheelHandler {
        acceptedModifiers: Qt.NoModifier
        property: "rotation"
    }

    WheelHandler {
        acceptedModifiers: Qt.ControlModifier
        property: "scale"
    }
}

Wenn dieser Handler das angegebene point bereits gegrabbt hat, wird dieses Signal ausgegeben, wenn das Grab von einem anderen Pointer Handler oder Item gestohlen wird.

Dieses Signal wird ausgegeben, wenn sich der Grab in irgendeiner Weise geändert hat, die für diesen Handler relevant ist.

Das transition (Verb) sagt, was passiert ist. Das point (Objekt) ist der Punkt, der gegriffen oder nicht gegriffen wurde.

Gültige Werte für transition sind:

Das Signal rotationChanged wird ausgegeben, wenn sich activeRotation (und damit persistentRotation) ändert. Der Wert delta gibt die additive Änderung der Rotation an. Wenn der Benutzer z. B. die Finger bewegt, um den Greifabstand zu ändern, so dass sich activeRotation von 10 auf 30 Grad ändert, wird rotationChanged(20) ausgegeben. Auf diese Weise können Sie die Drehung eines Objekts schrittweise ändern:

import QtQuick

Rectangle {
    width: 100; height: 100
    color: "lightsteelblue"

    PinchHandler {
        id: handler
        target: null
        onRotationChanged: (delta) => parent.rotation += delta // add
        onScaleChanged: (delta) => parent.scale *= delta // multiply
    }
}

Das Signal scaleChanged wird ausgegeben, wenn sich activeScale (und damit persistentScale) ändert. Der Wert delta gibt die multiplikative Änderung der Skala an. Wenn der Benutzer z. B. die Finger bewegt, um den Greifabstand zu ändern, so dass activeScale sich von 2 auf 2,5 ändert, wird das Signal scaleChanged(1.25) ausgegeben. Auf diese Weise können Sie den Maßstab eines Elements schrittweise ändern:

import QtQuick

Rectangle {
    width: 100; height: 100
    color: "lightsteelblue"

    PinchHandler {
        id: handler
        target: null
        onRotationChanged: (delta) => parent.rotation += delta // add
        onScaleChanged: (delta) => parent.scale *= delta // multiply
    }
}

Das Signal translationChanged wird ausgegeben, wenn sich activeTranslation (und damit persistentTranslation) ändert. Der delta Vektor gibt die Änderung der Übersetzung an. Damit können Sie die Position eines Elements schrittweise ändern:

import QtQuick

Window {
    width: 320; height: 240
    visible: true
    title: handler.persistentRotation.toFixed(1) + "° " +
           handler.persistentTranslation.x.toFixed(1) + ", " +
           handler.persistentTranslation.y.toFixed(1) + " " +
           (handler.persistentScale * 100).toFixed(1) + "%"

    PinchHandler {
        id: handler
        target: null
        persistentScale: 0.25
        onTranslationChanged: (delta) => {
            image.x -= delta.x
            image.y -= delta.y
        }
    }

    Image {
        id: image
        source: "images/album-cover.jpg"
        scale: handler.persistentScale
        x: -600; y: -450
    }
}