PinchArea QML Type

Ermöglicht die einfache Handhabung von Pinch-Gesten. Mehr...

Import Statement: import QtQuick
Inherits:

Item

Eigenschaften

Signale

Detaillierte Beschreibung

Der Typ PinchArea wurde in QtQuick 1.1 hinzugefügt.

Ein PinchArea ist ein unsichtbares Element, das in der Regel in Verbindung mit einem sichtbaren Element verwendet wird, um die Handhabung von Pinch-Gesten für dieses Element zu ermöglichen.

Die Eigenschaft enabled wird verwendet, um die Pinch-Behandlung für das vermittelte Element zu aktivieren und zu deaktivieren. Wenn sie deaktiviert ist, wird der Pinch-Bereich für Maus-/Berührungsereignisse transparent.

PinchArea kann auf zwei Arten verwendet werden:

  • Festlegen einer pinch.target, um eine automatische Interaktion mit einem Element zu ermöglichen
  • Verwendung der Handler onPinchStarted, onPinchUpdated und onPinchFinished

Seit Qt 5.5 kann PinchArea auf native Pinch-Gesten-Ereignisse des Betriebssystems reagieren, wenn diese verfügbar sind; andernfalls reagiert es nur auf Touch-Ereignisse.

Siehe auch PinchEvent, QNativeGestureEvent, und QTouchEvent.

Eigenschaft Dokumentation

enabled : bool

Diese Eigenschaft gibt an, ob das Element Pinch-Gesten akzeptiert.

Diese Eigenschaft ist standardmäßig auf true gesetzt.


pinch group

pinch.active : bool [read-only]

pinch.dragAxis : enumeration

pinch.maximumRotation : real

pinch.maximumScale : real

pinch.maximumX : real

pinch.maximumY : real

pinch.minimumRotation : real

pinch.minimumScale : real

pinch.minimumX : real

pinch.minimumY : real

pinch.target : Item

pinch bietet eine bequeme Möglichkeit, ein Element auf Pinch-Gesten reagieren zu lassen.

  • pinch.target gibt die ID des zu ziehenden Objekts an.
  • pinch.active gibt an, ob das Zielelement gerade gezogen wird.
  • pinch.minimumScale und pinch.maximumScale begrenzen den Bereich der Eigenschaft Item.scale, aber nicht die Eigenschaft PinchEvent scale .
  • pinch.minimumRotation und pinch.maximumRotation begrenzen den Bereich der Eigenschaft Item.rotation, aber nicht die Eigenschaft PinchEvent rotation .
  • pinch.dragAxis gibt an, ob das Ziehen nicht erlaubt ist (Pinch.NoDrag), ob es horizontal (Pinch.XAxis), vertikal (Pinch.YAxis) oder beides (Pinch.XAndYAxis) erfolgen kann
  • pinch.minimum und pinch.maximum begrenzen, wie weit das Ziel entlang der entsprechenden Achsen gezogen werden kann.

Signal Dokumentation

pinchFinished(PinchEvent pinch)

Dieses Signal wird ausgegeben, wenn der Pinch-Bereich erkennt, dass eine Pinch-Geste beendet wurde.

Der Parameter pinch (nicht identisch mit der Eigenschaft pinch ) liefert Informationen über die Pinch-Geste, einschließlich des Maßstabs, des Zentrums und des Winkels der Pinch-Geste.

Hinweis: Der entsprechende Handler ist onPinchFinished.


pinchStarted(PinchEvent pinch)

Dieses Signal wird ausgegeben, wenn der Pinch-Bereich erkennt, dass eine Pinch-Geste begonnen hat: Zwei Berührungspunkte (Finger) wurden erkannt, und sie haben sich über den Schwellenwert startDragDistance hinaus bewegt, damit die Geste beginnen kann.

Der Parameter pinch (nicht identisch mit der Eigenschaft pinch ) liefert Informationen über die Pinch-Geste, einschließlich des Maßstabs, der Mitte und des Winkels der Pinch-Geste. Zum Zeitpunkt des pinchStarted Signals werden diese Werte auf die Standardwerte zurückgesetzt, unabhängig von den Ergebnissen früherer Gesten: pinch.scale ist 1.0 und pinch.rotation ist 0.0. Im weiteren Verlauf der Geste wird pinchUpdated die Abweichung von diesen Standardwerten melden.

Um diese Geste zu ignorieren, setzen Sie die Eigenschaft pinch.accepted auf false. Die Geste wird dann abgebrochen und es werden keine weiteren Ereignisse gesendet.

Hinweis: Der entsprechende Handler ist onPinchStarted.


pinchUpdated(PinchEvent pinch)

Dieses Signal wird ausgegeben, wenn der Pinch-Bereich erkennt, dass sich eine Pinch-Geste geändert hat.

Der Parameter pinch liefert Informationen über die Pinch-Geste, einschließlich des Maßstabs, der Mitte und des Winkels der Pinch-Geste. Diese Werte spiegeln nur die Änderungen seit dem Beginn der aktuellen Geste wider und sind daher nicht durch die Mindest- und Höchstwerte in der Eigenschaft pinch begrenzt.

Hinweis: Der entsprechende Handler ist onPinchUpdated.


smartZoom(PinchEvent pinch)

Dieses Signal wird ausgesendet, wenn der Pinch-Bereich eine Smart-Zoom-Geste erkennt. Diese Geste tritt nur auf bestimmten Betriebssystemen wie macOS auf.

Der Parameter pinch liefert Informationen über die Pinch-Geste, einschließlich der Stelle, an der die Geste aufgetreten ist. pinch.scale ist größer als Null, wenn die Geste anzeigt, dass der Benutzer in den intelligenten Zoom wechseln möchte, und Null, wenn er ihn verlässt (auch wenn normalerweise dieselbe Geste verwendet wird, um zwischen den beiden Zuständen zu wechseln).

Hinweis: Der entsprechende Handler ist onSmartZoom.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.