PinchArea QML Type

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

• Liste aller Elemente, einschließlich geerbter Elemente

Eigenschaften

• enabled : bool
• pinch
  • pinch.active : bool
  • 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

Signale

• pinchFinished(PinchEvent pinch)
• pinchStarted(PinchEvent pinch)
• pinchUpdated(PinchEvent pinch)
• smartZoom(PinchEvent pinch)

Ausführliche Beschreibung

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

Die Eigenschaft „ enabled “ dient dazu, die Pinch-Gestenunterstützung für das vermittelte Element zu aktivieren oder zu deaktivieren. Bei Deaktivierung wird der Pinch-Bereich für Maus- und Touch-Ereignisse transparent.

„PinchArea“ kann auf zwei Arten verwendet werden:

• Festlegen von „ 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, sofern diese verfügbar sind; andernfalls reagiert es nur auf Touch-Ereignisse.

Siehe auch „ PinchEvent “, „ QNativeGestureEvent “ und „ QTouchEvent “.

Dokumentation zu den Eigenschaften

enabled : bool

Diese Eigenschaft gibt an, ob das Element Pinch-Gesten unterstützt.

Diese Eigenschaft ist standardmäßig auf „true“ gesetzt.

pinch group

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

• pinch.target Legt die ID des zu ziehenden Elements fest.
• pinch.active Gibt an, ob das Zielelement gerade gezogen wird.
• pinch.minimumScale und „ pinch.maximumScale “ begrenzen den Wertebereich der Eigenschaft „Item.scale“, nicht jedoch den der Eigenschaft „ PinchEvent “ scale.
• pinch.minimumRotation und ` pinch.maximumRotation ` begrenzen den Wertebereich der Eigenschaft `Item.rotation`, jedoch nicht den der Eigenschaft ` PinchEvent ` rotation.
• pinch.dragAxis Legt fest, ob das Ziehen nicht erlaubt ist (Pinch.NoDrag), horizontal (Pinch.XAxis), vertikal (Pinch.YAxis) oder beides (Pinch.XAndYAxis) möglich ist
• 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 zu verwechseln mit der Eigenschaft „ pinch “) liefert Informationen zur Pinch-Geste, darunter den Maßstab, den Mittelpunkt und den Winkel der Pinch-Geste.

pinchStarted(PinchEvent pinch)

Dieses Signal wird ausgegeben, wenn der Pinch-Bereich erkennt, dass eine Pinch-Geste begonnen hat: Es wurden zwei Berührungspunkte (Finger) erkannt, und diese haben den Schwellenwert „ startDragDistance “ überschritten, sodass die Geste beginnen kann.

Der Parameter „ pinch “ (nicht zu verwechseln mit der Eigenschaft „ pinch “) liefert Informationen zur Pinch-Geste, darunter den Maßstab, den Mittelpunkt und den Winkel der Pinch-Geste. Zum Zeitpunkt des Signals „ pinchStarted “ werden diese Werte unabhängig von den Ergebnissen vorheriger Gesten auf die Standardwerte zurückgesetzt: „pinch.scale“ lautet „ 1.0 “ und „pinch.rotation“ lautet „ 0.0 “. Im Verlauf der Geste meldet „ pinchUpdated “ die Abweichung von diesen Standardwerten.

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

pinchUpdated(PinchEvent pinch)

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

Der Parameter „ pinch “ liefert Informationen zur Pinch-Geste, darunter den Maßstab, den Mittelpunkt und den Winkel der Pinch-Geste. Diese Werte spiegeln nur die Änderungen seit Beginn der aktuellen Geste wider und unterliegen daher nicht den Minimal- und Maximalgrenzen der Eigenschaft „ pinch “.

smartZoom(PinchEvent pinch)

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

Der Parameter „ pinch “ liefert Informationen zur Pinch-Geste, einschließlich der Stelle, an der die Geste ausgeführt wurde. „ pinch.scale “ ist größer als Null, wenn die Geste anzeigt, dass der Benutzer den Smart-Zoom aktivieren möchte, und gleich Null beim Beenden (auch wenn in der Regel dieselbe Geste zum Umschalten zwischen den beiden Zuständen verwendet wird).