handlerPoint QML Type
Ein Ereignispunkt. Mehr...
| Import Statement: | import QtQuick |
Eigenschaften
- device : PointerDevice
- ellipseDiameters : size
- id : int
- modifiers : enumeration
- position : point
- pressPosition : point
- pressedButtons : enumeration
- pressure : real
- rotation : real
- sceneGrabPosition : point
- scenePosition : point
- scenePressPosition : point
- uniqueId : pointingDeviceUniqueId
- velocity : vector2d
Detaillierte Beschreibung
Eine handler-eigene QML-Darstellung eines QEventPoint.
Es ist möglich, Bindungen zu Eigenschaften des aktuellen point oder centroid eines Handlers herzustellen. Zum Beispiel:
import QtQuick Item { width: 640 height: 480 DragHandler { id: handler target: null } Text { color: handler.active ? "darkgreen" : "black" text: handler.centroid.position.x.toFixed(1) + "," + handler.centroid.position.y.toFixed(1) x: handler.centroid.position.x - width / 2 y: handler.centroid.position.y - height } }
Der Punkt wird auf dem neuesten Stand gehalten, wenn DragHandler aktiv auf einen eventPoint antwortet; aber nachdem der Punkt freigegeben wurde oder wenn der aktuelle Punkt von einem anderen Handler behandelt wird, sind position.x und position.y 0.
Hinweis: Dies ist praktisch identisch mit eventPoint; allerdings ist eventPoint eine kurzlebige Kopie eines langlebigen Q_GADGET, die zwischen Gesten ungültig gemacht und für nachfolgende Ereignislieferungen wiederverwendet wird. Kontinuierliche Bindungen an seine Eigenschaften sind nicht möglich, und ein einzelner Handler kann sich außerhalb des Zeitraums, in dem dieser Punkt Teil einer aktiven Geste ist, die dieser Handler bearbeitet, nicht auf ihn verlassen. handlerPoint ist eine Q_GADGET, die der Handler besitzt. Dies ermöglicht es Ihnen, lebenslange Bindungen an seine Eigenschaften vorzunehmen.
Siehe auch SinglePointHandler::point und MultiPointHandler::centroid.
Eigenschaft Dokumentation
device : PointerDevice |
Diese Eigenschaft enthält das Gerät, von dem der Punkt (und sein Ereignis) stammt.
ellipseDiameters : size |
Diese Eigenschaft enthält die Durchmesser der Berührungsfläche, wenn das Ereignis von einem Berührungspunkt stammt und das Gerät diese Informationen bereitstellt.
Ein Berührungspunkt wird als ein elliptischer Bereich modelliert, in dem der Finger gegen den Touchscreen gedrückt wird. (Tatsächlich könnte er auch als Bitmap modelliert werden; in diesem Fall erwarten wir jedoch, dass eine elliptische Begrenzungsschätzung an die Kontaktfläche angepasst wird, bevor das Ereignis gesendet wird.) Je stärker der Benutzer drückt, desto größer ist die Kontaktfläche; diese Durchmesser bieten also eine alternative Möglichkeit, Druck zu erkennen, falls das Gerät keinen separaten Drucksensor enthält. Die Ellipse ist auf scenePosition zentriert (position in den lokalen Koordinaten des Elements von PointerHandler). Die Eigenschaft rotation gibt die Drehung der Ellipse an, falls bekannt. Wenn rotation gleich Null ist, wird erwartet, dass height die größere Dimension (die Hauptachse) ist, da die Hand normalerweise nach oben oder außen über die Oberfläche streicht.
Ist die Kontaktfläche unbekannt oder handelt es sich bei dem Gerät nicht um einen Touchscreen, sind diese Werte gleich Null.
Siehe auch QtQuick::TouchPoint::ellipseDiameters und QEventPoint::ellipseDiameters.
id : int |
Die ID-Nummer des Punktes
Während einer Berührungsgeste, vom Drücken des ersten Fingers bis zum Loslassen des letzten Fingers, hat jeder Berührungspunkt eine eindeutige ID-Nummer. Wenn Eingaben von mehreren Geräten erfolgen (z. B. gleichzeitiges Drücken von Maus und Touch), haben alle aktuellen eventPoints von allen Geräten eindeutige IDs.
Hinweis: Gehen Sie nicht davon aus, dass die ID-Nummern bei Null beginnen oder dass sie fortlaufend sind. Eine solche Annahme ist aufgrund der Arbeitsweise der zugrunde liegenden Treiber oft falsch.
Siehe auch QEventPoint::id.
modifiers : enumeration |
Welche Modifikatortasten gerade gedrückt werden
Diese Eigenschaft enthält die Tastaturmodifikatoren, die zum Zeitpunkt des Auftretens des Ereignisses gedrückt wurden.
position : point |
Die Position innerhalb des parent Elements
Dies ist die Position von eventPoint relativ zu den Grenzen von parent.
pressPosition : point |
Die gedrückte Position innerhalb des parent Elements
Hierbei handelt es sich um die Position, an der dieser Punkt gedrückt wurde, relativ zu den Grenzen des parent.
pressedButtons : enumeration |
Welche Maus- oder Stifttasten gerade gedrückt sind
Siehe auch MouseArea::pressedButtons.
pressure : real |
Diese Eigenschaft gibt an, wie stark der Benutzer den Stift auf einem Grafiktablett oder den Finger auf einem Touchscreen drückt, im Bereich von 0 (kein messbarer Druck) bis 1.0 (maximaler Druck, den das Gerät messen kann).
Er ist nur bei bestimmten Tablets und Touchscreens gültig, die Druck messen können. Andernfalls ist sie gleich Null.
rotation : real |
Diese Eigenschaft enthält den Drehwinkel des Stiftes auf einem Grafiktablett oder die Kontaktfläche eines Berührungspunktes auf einem Touchscreen.
Sie ist nur bei bestimmten Tablettstiften und Touchscreens gültig, die den Drehwinkel messen können. Andernfalls ist er gleich Null.
sceneGrabPosition : point |
Die gegriffene Position innerhalb der Szene
Wenn dieser Punkt von einem Pointer Handler oder einem Item gegrabbt wurde, bedeutet dies, dass dieses Objekt die alleinige Verantwortung für die Bewegung und das Loslassen dieses Punktes übernommen hat. In diesem Fall ist dies die Position, an der der Punkt gegriffen wurde, im Koordinatensystem des Szenegraphen.
scenePosition : point |
Die Position innerhalb der Szene
Dies ist die Position von eventPoint relativ zu den Grenzen der Qt Quick Szene (typischerweise das gesamte Fenster).
scenePressPosition : point |
Die gedrückte Position innerhalb der Szene
Dies ist die Position, an der dieser Punkt gedrückt wurde, im Koordinatensystem des Szenengraphs.
uniqueId : pointingDeviceUniqueId |
Die eindeutige ID des Punktes, falls vorhanden
Diese Angabe ist normalerweise leer, da Touchscreens Finger nicht eindeutig identifizieren können.
Bei einigen Arten von Touchscreens, insbesondere bei solchen, die TUIO-Treiber verwenden, ist es möglich, zusätzlich zu den Fingern erkennbare physische Zeichen (Fiducial Objects) zu verwenden. Wenn dieser Punkt also ein Berührungspunkt ist und uniqueId gesetzt ist, ist dies der Bezeichner für ein solches Objekt.
Auf einem Grafiktablett hat jede Art von Stift oder anderem Werkzeug oft eine eindeutige ID oder Seriennummer, die nützlich sein kann, um auf unterschiedliche Weise auf verschiedene Werkzeuge zu reagieren.
Die Interpretation des Inhalts dieser ID erfordert Kenntnisse über die verwendete Hardware und die Treiber.
Siehe auch QTabletEvent::uniqueId und QtQuick::TouchPoint::uniqueId.
velocity : vector2d |
Ein Vektor, der die durchschnittliche Geschwindigkeit und die Richtung der Bewegung angibt
Dies ist ein Geschwindigkeitsvektor, der in die Richtung der Bewegung zeigt, in logischen Pixeln pro Sekunde. Er hat eine x- und eine y-Komponente, von denen mindestens eine ungleich Null ist, wenn dieser Punkt in Bewegung ist. Er enthält die durchschnittliche Geschwindigkeit der letzten Zeit: wie schnell und in welche Richtung sich die eventPoint in letzter Zeit bewegt hat.
Siehe auch QtQuick::TouchPoint::velocity und QEventPoint::velocity.
© 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.
