PinchArea QML Type
Ermöglicht die einfache Handhabung von Pinch-Gesten. Mehr...
Import Statement: | import QtQuick |
Inherits: |
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)
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
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
undpinch.maximumScale
begrenzen den Bereich der Eigenschaft Item.scale, aber nicht die EigenschaftPinchEvent
scale .pinch.minimumRotation
undpinch.maximumRotation
begrenzen den Bereich der Eigenschaft Item.rotation, aber nicht die EigenschaftPinchEvent
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 kannpinch.minimum
undpinch.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.