handlerPoint QML Type

Un point d'événement. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• 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

Description détaillée

Représentation QML d'une QEventPoint, gérée par un gestionnaire.

Il est possible d’établir des liaisons avec les propriétés de l’ point ou de l’ centroid actuel d’un gestionnaire. Par exemple :

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
    }
}

Le point est maintenu à jour lorsque l’ DragHandler répond activement à un eventPoint; mais une fois le point relâché, ou lorsque le point actuel est géré par un autre gestionnaire, position.x et position.y prennent la valeur 0.

Voir également SinglePointHandler::point et MultiPointHandler::centroid.

Documentation sur les propriétés

device : PointerDevice [read-only]

Cette propriété contient le périphérique d'où provient le point (et son événement).

ellipseDiameters : size [read-only]

Cette propriété contient les diamètres de la zone de contact, si l'événement provient d'un point de contact et que l'appareil fournit cette information.

Un point de contact est modélisé comme une zone elliptique où le doigt appuie sur l'écran tactile. (En réalité, il pourrait également être modélisé sous forme d'image bitmap ; mais dans ce cas, on s'attend à ce qu'une estimation elliptique des limites soit ajustée à la zone de contact avant l'envoi de l'événement.) Plus l’utilisateur appuie fort, plus la zone de contact est grande ; ces diamètres constituent donc un autre moyen de détecter la pression, au cas où l’appareil ne disposerait pas d’un capteur de pression dédié. L’ellipse est centrée sur scenePosition (position dans les coordonnées locales de l’élément de l’ PointerHandler). La propriété « rotation » indique la rotation de l’ellipse, si elle est connue. On s’attend à ce que, si la rotation « rotation » est nulle, la rotation « height » corresponde à la plus grande dimension (l’axe majeur), en raison de la position habituelle de la main, qui tend vers le haut ou vers l’extérieur sur la surface.

Si la zone de contact est inconnue, ou si l’appareil n’est pas un écran tactile, ces valeurs seront égales à zéro.

Voir également QtQuick::TouchPoint::ellipseDiameters et QEventPoint::ellipseDiameters.

id : int [read-only]

Le numéro d'identification du point

Lors d’un geste tactile, entre le moment où le premier doigt est appuyé et celui où le dernier doigt est relâché, chaque point de contact se voit attribuer un numéro d’identification unique. De même, en cas d’ eventPoints s provenant de plusieurs périphériques (par exemple, des clics de souris et des pressions tactiles simultanés), toutes les s en cours provenant de l’ensemble des périphériques auront des identifiants uniques.

Voir également QEventPoint::id.

modifiers : enumeration [read-only]

Quelles touches de modification sont actuellement enfoncées ?

Cette propriété contient les touches de modification du clavier qui étaient enfoncées au moment où l'événement s'est produit.

position : point [read-only]

L'emplacement au sein de l'parent Item

Il s'agit de la position de l'eventPoint par rapport aux limites de l'parent.

pressPosition : point [read-only]

La position d'appui au sein de l'élément « parent »

Il s'agit de la position à laquelle ce point a été cliqué, par rapport aux limites de l'parent.

pressedButtons : enumeration [read-only]

Quels boutons de la souris ou du stylet sont actuellement enfoncés ?

Voir également MouseArea::pressedButtons.

pressure : real [read-only]

Cette propriété indique la force avec laquelle l'utilisateur appuie avec le stylet sur une tablette graphique ou avec le doigt sur un écran tactile, dans une plage allant de 0 (aucune pression mesurable) à 1.0 (pression maximale que l'appareil peut mesurer).

Elle n'est valable qu'avec certaines tablettes et certains écrans tactiles capables de mesurer la pression. Dans le cas contraire, sa valeur sera nulle.

rotation : real [read-only]

Cette propriété stocke l'angle de rotation du stylet sur une tablette graphique ou la zone de contact d'un point tactile sur un écran tactile.

Elle n'est valide qu'avec certains stylets de tablette et écrans tactiles capables de mesurer l'angle de rotation. Dans le cas contraire, sa valeur sera nulle.

sceneGrabPosition : point [read-only]

La position saisie au sein de la scène

Si ce point a été saisi par un Pointer Handler ou un Item, cela signifie que cet objet a pris en charge à lui seul la gestion du déplacement et de la libération de ce point. Dans ce cas, il s'agit de la position à laquelle la saisie a eu lieu, dans le système de coordonnées du graphe de scène.

scenePosition : point [read-only]

La position au sein de la scène

Il s'agit de la position de l'eventPoint par rapport aux limites de la scène Qt Quick (généralement l'ensemble de la fenêtre).

scenePressPosition : point [read-only]

La position où le bouton a été enfoncé dans la scène

Il s'agit de la position à laquelle ce point a été cliqué, dans le système de coordonnées du graphe de scène.

uniqueId : pointingDeviceUniqueId [read-only]

L'identifiant unique du point, le cas échéant

Ce champ est généralement vide, car les écrans tactiles ne peuvent pas identifier de manière unique les doigts.

Sur certains types d’écrans tactiles, en particulier ceux utilisant des pilotes TUIO, il est possible d’utiliser des repères physiques reconnaissables (objets de référence) en plus des doigts. Ainsi, si ce point est un point de contact et que le champ « uniqueId » est renseigné, il s’agit de l’identifiant d’un tel objet.

Sur une tablette graphique, chaque type de stylet ou autre outil dispose souvent d’un identifiant unique ou d’un numéro de série, ce qui peut s’avérer utile pour répondre de manière différente selon les outils utilisés.

L'interprétation du contenu de cet identifiant nécessite une connaissance du matériel et des pilotes utilisés.

Voir également QTabletEvent::uniqueId et QtQuick::TouchPoint::uniqueId.

velocity : vector2d [read-only]

Un vecteur représentant la vitesse moyenne et la direction du mouvement

Il s'agit d'un vecteur de vitesse orienté dans la direction du mouvement, exprimé en pixels logiques par seconde. Il comporte des composantes x et y, dont au moins une sera différente de zéro lorsque ce point est en mouvement. Il contient la vitesse moyenne récente : à quelle vitesse et dans quelle direction l'eventPoint e s'est déplacé récemment.

Voir également « QtQuick::TouchPoint::velocity » et « QEventPoint::velocity ».