handlerPoint QML Type

Ein Ereignispunkt. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

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

Ausführliche Beschreibung

Eine vom Handler verwaltete 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, solange der „ DragHandler “ aktiv auf einen „ eventPoint “ reagiert; sobald der Punkt jedoch freigegeben wird oder der aktuelle Punkt von einem anderen Handler verarbeitet wird, sind „ position.x “ und „ position.y “ gleich 0.

Siehe auch SinglePointHandler::point und MultiPointHandler::centroid.

Dokumentation zu den Eigenschaften

device : PointerDevice [read-only]

Diese Eigenschaft enthält das Gerät, von dem der Punkt (und sein Ereignis) stammt.

ellipseDiameters : size [read-only]

Diese Eigenschaft enthält die Durchmesser der Berührungsfläche, sofern das Ereignis von einem Berührungspunkt stammt und das Gerät diese Informationen bereitstellt.

Ein Berührungspunkt wird als elliptischer Bereich modelliert, in dem der Finger auf den Touchscreen gedrückt wird. (Tatsächlich könnte er auch als Bitmap modelliert werden; in diesem Fall erwarten wir jedoch, dass vor dem Senden des Ereignisses eine elliptische Begrenzungsschätzung an die Kontaktfläche angepasst wird.) Je stärker der Benutzer drückt, desto größer ist die Kontaktfläche; daher bieten diese Durchmesser eine alternative Möglichkeit zur Druckerfassung, falls das Gerät keinen separaten Drucksensor enthält. Der Mittelpunkt der Ellipse liegt bei scenePosition (position in den lokalen Koordinaten des „Item“ des „ PointerHandler “). Die Eigenschaft „ rotation “ gibt die Drehung der Ellipse an, sofern bekannt. Es wird davon ausgegangen, dass bei einem Wert von „ rotation “ gleich Null die „ height “ die größere Abmessung (die Hauptachse) ist, da die Hand üblicherweise so positioniert ist, dass sie nach oben oder nach außen über die Oberfläche greift.

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 [read-only]

Die ID-Nummer des Berührungspunkts

Während einer Berührungsgeste, vom Zeitpunkt des Auflegens des ersten Fingers bis zum Abheben des letzten Fingers, erhält jeder Berührungspunkt eine eindeutige ID-Nummer. Ebenso erhalten bei Eingaben von mehreren Geräten (z. B. gleichzeitige Maus- und Touch-Eingaben) alle aktuellen „ eventPoints “ von allen Geräten eindeutige IDs.

Siehe auch „ QEventPoint::id “.

modifiers : enumeration [read-only]

Welche Modifikatortasten sind derzeit gedrückt?

Diese Eigenschaft enthält die Modifikatortasten, die zum Zeitpunkt des Ereignisses gedrückt waren.

position : point [read-only]

Die Lage des „ parent “

Dies ist die Position des „ eventPoint “ relativ zu den Begrenzungen des „ parent “.

pressPosition : point [read-only]

Die Druckposition innerhalb des „ parent “-Elements

Dies ist die Position, an der dieser Punkt angeklickt wurde, relativ zu den Begrenzungen von „ parent “.

pressedButtons : enumeration [read-only]

Welche Maus- oder Stylus-Tasten sind derzeit gedrückt?

Siehe auch MouseArea::pressedButtons.

pressure : real [read-only]

Diese Eigenschaft gibt an, wie stark der Benutzer den Stift auf einem Grafiktablett oder den Finger auf einem Touchscreen drückt, und zwar im Bereich von 0 (kein messbarer Druck) bis 1.0 (maximaler Druck, den das Gerät messen kann).

Sie ist nur bei bestimmten Grafiktabletts und Touchscreens gültig, die den Druck messen können. Andernfalls ist ihr Wert Null.

rotation : real [read-only]

Diese Eigenschaft gibt den Drehwinkel des Stifts auf einem Grafiktablett oder die Kontaktfläche eines Berührungspunkts auf einem Touchscreen an.

Sie ist nur bei bestimmten Grafiktabletten und Touchscreens gültig, die den Drehwinkel messen können. Andernfalls ist ihr Wert Null.

sceneGrabPosition : point [read-only]

Die erfasste Position innerhalb der Szene

Wenn dieser Punkt von einem Pointer-Handler oder einem Item ergriffen wurde, bedeutet dies, dass dieses Objekt die alleinige Verantwortung für die Steuerung der Bewegung und das Loslassen dieses Punktes übernommen hat. In diesem Fall handelt es sich um die Position, an der das Ergreifen stattfand, im Koordinatensystem des Szenengraphen.

scenePosition : point [read-only]

Die Position innerhalb der Szene

Dies ist die Position von „ eventPoint “ relativ zu den Begrenzungen der Szene „ Qt Quick “ (in der Regel das gesamte Fenster).

scenePressPosition : point [read-only]

Die Position, an der die Taste gedrückt wurde, innerhalb der Szene

Dies ist die Position, an der dieser Punkt angeklickt wurde, im Koordinatensystem des Szenengraphen.

uniqueId : pointingDeviceUniqueId [read-only]

Die eindeutige ID des Punktes, falls vorhanden

Dieses Feld ist normalerweise leer, da Touchscreens Finger nicht eindeutig identifizieren können.

Bei einigen Arten von Touchscreens, insbesondere solchen, die TUIO-Treiber verwenden, ist es möglich, zusätzlich zu Fingern erkennbare physische Marker (Fiducial-Objekte) zu verwenden. Wenn es sich bei diesem Punkt also um einen Berührungspunkt handelt und „uniqueId“ gesetzt ist, ist dies die Kennung für ein solches Objekt.

Bei einem Grafiktablett verfügt jede Art von Stift oder anderem Werkzeug oft über eine eindeutige ID oder Seriennummer, was nützlich sein kann, um auf verschiedene Werkzeuge unterschiedlich 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 [read-only]

Ein Vektor, der die durchschnittliche Geschwindigkeit und Bewegungsrichtung angibt

Dies ist ein Geschwindigkeitsvektor, der in Bewegungsrichtung zeigt und in logischen Pixeln pro Sekunde angegeben wird. Er verfügt über x- und y-Komponenten, von denen mindestens eine ungleich Null ist, wenn sich dieser Punkt bewegt. Er enthält die durchschnittliche Geschwindigkeit der letzten Zeit: wie schnell und in welche Richtung sich der eventPoint in letzter Zeit bewegt hat.

Siehe auch „ QtQuick::TouchPoint::velocity “ und „ QEventPoint::velocity “.