TouchPoint QML Type

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

Import Statement: import QtQuick

Eigenschaften

Detaillierte Beschreibung

Der Typ TouchPoint enthält Informationen über einen Berührungspunkt, wie die aktuelle Position, den Druck und den Bereich.

Eigenschaft Dokumentation

x : real [read-only]

y : real [read-only]

Diese Eigenschaften enthalten die aktuelle Position des Berührungspunkts.


pressure : real [read-only]

velocity : vector2d [read-only]

Diese Eigenschaften enthalten zusätzliche Informationen über den 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 Pixel pro Sekunde angegeben wird.

Nicht alle Touch-Geräte unterstützen Velocity. Wenn Velocity nicht unterstützt wird, wird es als 0,0 gemeldet.


startX : real [read-only]

startY : real [read-only]

Diese Eigenschaften geben die Startposition des Berührungspunktes an.


previousX : real [read-only]

previousY : real [read-only]

Diese Eigenschaften halten die vorherige Position des Berührungspunkts fest.


sceneX : real [read-only]

sceneY : real [read-only]

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


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 einer MultiPointTouchArea hat eine eindeutige ID.


pressed : bool [read-only]

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


rotation : real [read-only]

Diese Eigenschaft gibt die Winkelausrichtung des Berührungspunktes an. Der Rückgabewert wird in Grad angegeben, wobei Null (der Standardwert) bedeutet, dass der Finger oder die Marke nach oben zeigt, ein negativer Winkel bedeutet, dass er nach links gedreht ist, und ein positiver Winkel bedeutet, dass er nach rechts gedreht ist. Die meisten Touchscreens erkennen die Drehung nicht, daher ist Null der gebräuchlichste Wert.

Siehe auch QEventPoint::rotation().


uniqueId : pointingDeviceUniqueId [read-only]

Diese Eigenschaft enthält die eindeutige ID des Touchpoints oder Tokens.

Sie ist normalerweise leer, da Touchscreens Finger nicht eindeutig identifizieren können. Wenn sie jedoch gesetzt ist, 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).


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