handlerPoint QML Type

Un point d'événement. Plus d'informations...

• 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'un QEventPoint appartenant à un gestionnaire.

Il est possible d'établir des liens avec les propriétés de la page point ou centroid actuelle d'un gestionnaire. Par exemple, le point est maintenu à jour lorsque le est en cours de traitement :

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 le DragHandler répond activement à un eventPoint; mais une fois le point libéré, ou lorsque le point actuel est traité par un autre gestionnaire, position.x et position.y sont à 0.

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

Documentation sur les propriétés

device : PointerDevice [read-only]

Cette propriété contient le dispositif 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 est pressé contre l'écran tactile. (En fait, il pourrait également être modélisé comme une image bitmap ; mais dans ce cas, nous nous attendons à ce qu'une estimation elliptique soit ajustée à la zone de contact avant que l'événement ne soit envoyé). 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 comporterait pas de capteur de pression séparé. L'ellipse est centrée sur scenePosition (position dans les coordonnées locales de l'élément PointerHandler). La propriété rotation indique la rotation de l'ellipse, si elle est connue. Si la propriété rotation est nulle, on s'attend à ce que la propriété height soit la plus grande dimension (l'axe principal), en raison de la position habituelle de la main, qui tend la main vers le haut ou vers l'extérieur de la surface.

Si la surface de contact est inconnue ou si l'appareil n'est pas un écran tactile, ces valeurs seront nulles.

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 pressé et le moment où le dernier doigt est relâché, chaque point de contact aura un numéro d'identification unique. De même, en cas de saisie à partir de plusieurs dispositifs (par exemple, pressions simultanées de la souris et du doigt), tous les eventPoints actuels de tous les dispositifs auront des numéros d'identification uniques.

Voir aussi QEventPoint::id.

modifiers : enumeration [read-only]

Quelles sont les touches de modification 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]

Position à l'intérieur de l'élément parent

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

pressPosition : point [read-only]

Position enfoncée dans l'élément parent

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

pressedButtons : enumeration [read-only]

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

Voir aussi MouseArea::pressedButtons.

pressure : real [read-only]

Cette propriété indique la force avec laquelle l'utilisateur appuie sur le stylet d'une tablette graphique ou sur le doigt d'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 que pour certaines tablettes et certains écrans tactiles qui peuvent mesurer la pression. Dans le cas contraire, elle sera égale à zéro.

rotation : real [read-only]

Cette propriété indique 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 valable que pour certaines tablettes et certains écrans tactiles qui peuvent mesurer l'angle de rotation. Dans le cas contraire, il sera égal à zéro.

sceneGrabPosition : point [read-only]

La position saisie dans la scène

Si ce point a été saisi par un gestionnaire de pointeur ou un élément, cela signifie que cet objet a pris l'entière responsabilité de gérer le mouvement et 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 la scène.

scenePosition : point [read-only]

La position dans la scène

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

scenePressPosition : point [read-only]

La position pressée dans la scène

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

uniqueId : pointingDeviceUniqueId [read-only]

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

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

Sur certains types d'écrans tactiles, en particulier ceux qui utilisent des pilotes TUIO, il est possible d'utiliser des jetons physiques reconnaissables (objets fiduciaux) en plus des doigts. Par conséquent, si ce point est un point tactile et que uniqueId est défini, il s'agit de l'identifiant d'un tel objet.

Sur une tablette graphique, chaque type de stylet ou autre outil possède souvent un identifiant unique ou un numéro de série, ce qui peut être utile pour répondre de différentes manières à différents outils.

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 pointant dans la direction du mouvement, en pixels logiques par seconde. Il possède des composantes x et y, dont au moins une sera non nulle lorsque ce point est en mouvement. Il contient la vitesse moyenne récente : à quelle vitesse et dans quelle direction le site eventPoint s'est récemment déplacé.

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