Sur cette page

TouchPoint QML Type

Décrit un point de contact dans un « MultiPointTouchArea ». En savoir 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 surface.

Tableau présentant les points de contact avec leurs paramètres : rectangle englobant, rotation et diamètres des ellipses

Documentation des 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 « MultiPointTouchArea » possède un identifiant unique.

pressed : bool [read-only]

Cette propriété indique si le point tactile 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 tactile.

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

Tous les périphériques tactiles ne prennent pas en charge la vitesse. Si la vitesse n'est pas prise en charge, elle sera indiquée comme 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é contient l'orientation angulaire de ce point de contact. La valeur renvoyée est exprimée en degrés : zéro (valeur par défaut) indique que le doigt ou le jeton est orienté vers le haut, un angle négatif signifie qu'il est tourné vers la gauche, et un angle positif signifie qu'il est tourné vers la droite. La plupart des écrans tactiles ne détectent pas la rotation ; la valeur zéro est donc 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 dans les coordonnées de la scène.

startX : real [read-only]

startY : real [read-only]

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

uniqueId : pointingDeviceUniqueId [read-only]

Cette propriété contient l'identifiant unique du point de contact ou du repère.

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

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.