Auf dieser Seite

TouchPoint QML Type

Beschreibt einen Berührungspunkt in einem „ MultiPointTouchArea “. Mehr...

Import Statement: import QtQuick

Eigenschaften

Ausführliche Beschreibung

Der Typ „TouchPoint“ enthält Informationen zu einem Berührungspunkt, wie beispielsweise die aktuelle Position, den Druck und die Fläche.

Tablet mit angezeigten Berührungspunkten und entsprechenden Messwerten: Begrenzungsrahmen, Drehung und Ellipsendurchmesser

Dokumentation der Eigenschaften

ellipseDiameters : size [read-only]

Diese Eigenschaft enthält die Haupt- und Nebenachse der Ellipse, die den abgedeckten Bereich des Berührungspunkts darstellt.

pointId : int [read-only]

Diese Eigenschaft enthält die Punkt-ID des Berührungspunkts.

Jeder Berührungspunkt innerhalb eines „ MultiPointTouchArea “ verfügt über eine eindeutige ID.

pressed : bool [read-only]

Diese Eigenschaft gibt an, ob der Berührungspunkt gerade gedrückt wird.

pressure : real [read-only]

velocity : vector2d [read-only]

Diese Eigenschaften enthalten zusätzliche Informationen zum aktuellen Zustand des Berührungspunkts.

  • pressure ist ein Wert im Bereich von 0,0 bis 1,0.
  • velocity ist ein Vektor, dessen Größe in Pixeln pro Sekunde angegeben wird.

Nicht alle Touch-Geräte unterstützen die Geschwindigkeitsmessung. Wird die Geschwindigkeitsmessung nicht unterstützt, wird der Wert als 0,0 gemeldet.

previousX : real [read-only]

previousY : real [read-only]

Diese Eigenschaften geben die vorherige Position des Berührungspunkts an.

rotation : real [read-only]

Diese Eigenschaft enthält die Winkelausrichtung dieses Berührungspunkts. Der Rückgabewert wird in Grad angegeben, wobei Null (Standardwert) bedeutet, dass der Finger oder das Token nach oben zeigt, ein negativer Winkel bedeutet, dass es nach links gedreht ist, und ein positiver Winkel bedeutet, dass es nach rechts gedreht ist. Die meisten Touchscreens erkennen keine Drehung, daher ist Null der häufigste Wert.

Siehe auch ` QEventPoint::rotation()`.

sceneX : real [read-only]

sceneY : real [read-only]

Diese Eigenschaften enthalten die aktuelle Position des Berührungspunkts in Szenenkoordinaten.

startX : real [read-only]

startY : real [read-only]

Diese Eigenschaften geben die Startposition des Berührungspunkts an.

uniqueId : pointingDeviceUniqueId [read-only]

Diese Eigenschaft enthält die eindeutige ID des Berührungspunkts oder Tokens.

Normalerweise ist sie leer, da Touchscreens Finger nicht eindeutig identifizieren können. Ist sie jedoch gesetzt, wird erwartet, dass sie ein bestimmtes Token (Referenzobjekt) eindeutig identifiziert.

Die Interpretation des Inhalts dieser ID erfordert Kenntnisse über die verwendete Hardware und die Treiber (z. B. verschiedene TUIO-basierte Touch-Oberflächen).

x : real [read-only]

y : real [read-only]

Diese Eigenschaften geben die aktuelle Position des Berührungspunkts an.

© 2026 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.