Sur cette page

TouchPoint QML Type

Décrit un point de contact dans un site MultiPointTouchArea. Plus....

Import Statement: import QtQuick

Propriétés

Description détaillée

Le type TouchPoint contient des informations sur un point de contact, telles que la position actuelle, la pression et la zone.

Documentation sur les propriétés

ellipseDiameters : size [read-only]

Cette propriété contient les axes majeur et mineur de l'ellipse représentant la zone couverte par le point de contact.

pointId : int [read-only]

Cette propriété contient l'identifiant du point de contact.

Chaque point de contact au sein d'un site MultiPointTouchArea aura un identifiant unique.

pressed : bool [read-only]

Cette propriété indique si le point de contact est actuellement enfoncé.

pressure : real [read-only]

velocity : vector2d [read-only]

Ces propriétés contiennent des informations supplémentaires sur l'état actuel du point de contact.

  • pressure est une valeur comprise entre 0,0 et 1,0.
  • velocity est un vecteur dont la magnitude est exprimée en pixels par seconde.

Tous les dispositifs tactiles ne prennent pas en charge la vitesse. Si la vélocité n'est pas prise en charge, elle sera déclarée sous la forme 0,0.

previousX : real [read-only]

previousY : real [read-only]

Ces propriétés contiennent la position précédente du point de contact.

rotation : real [read-only]

Cette propriété indique l'orientation angulaire du point de contact. La valeur de retour est exprimée en degrés, où zéro (valeur par défaut) indique que le doigt ou le jeton pointe vers le haut, un angle négatif signifie qu'il a pivoté vers la gauche et un angle positif signifie qu'il a pivoté vers la droite. La plupart des écrans tactiles ne détectent pas la rotation, de sorte que zéro est la valeur la plus courante.

Voir également QEventPoint::rotation().

sceneX : real [read-only]

sceneY : real [read-only]

Ces propriétés contiennent la position actuelle du point de contact en coordonnées de scène.

startX : real [read-only]

startY : real [read-only]

Ces propriétés définissent la position initiale du point de contact.

uniqueId : pointingDeviceUniqueId [read-only]

Cette propriété contient l'identifiant unique du point de contact ou du jeton.

Elle est normalement vide, car les écrans tactiles ne peuvent pas identifier les doigts de manière unique. Mais lorsqu'elle est définie, elle est censée identifier de manière unique un jeton spécifique (objet fiduciaire).

L'interprétation du contenu de cet identifiant nécessite une connaissance du matériel et des pilotes utilisés (par exemple, diverses surfaces tactiles basées sur TUIO).

x : real [read-only]

y : real [read-only]

Ces propriétés contiennent la position actuelle du point de contact.

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