PointerDevice QML Type
Équivalent QML de QPointingDevice. En savoir plus...
| Import Statement: | import QtQuick |
| In C++: | QPointingDevice |
Propriétés
- buttonCount : int
- deviceType : enumeration
- maximumPoints : int
- pointerType : enumeration
- uniqueId : pointingDeviceUniqueId
Signaux
- grabChanged(QtObject grabber, enumeration transition, PointerEvent event, eventPoint point)
Description détaillée
PointerDevice est le nom QML de la classe QPointingDevice. Elle possède les mêmes propriétés et énumérations que QPointingDevice.
Documentation des propriétés
buttonCount : int [read-only]
Cette propriété indique le nombre maximal de boutons intégrés à l'appareil pouvant être détectés.
deviceType : enumeration
Cette propriété indique le type d'appareil à l'origine d'un message « PointerEvent ».
Les valeurs valides sont les suivantes :
| Constante | Description |
|---|---|
PointerDevice.Unknown | Le périphérique ne peut pas être identifié. |
PointerDevice.Mouse | Une souris. |
PointerDevice.TouchScreen | Un écran tactile. |
PointerDevice.TouchPad | Un pavé tactile ou un trackpad. |
PointerDevice.Stylus | Un stylet sur une tablette graphique. |
PointerDevice.Airbrush | Un aérographe sur une tablette graphique. |
PointerDevice.Puck | Un numériseur avec réticule, sur une tablette graphique. |
Voir aussi QInputDevice::DeviceType et PointerDeviceHandler::acceptedDevices.
maximumPoints : int [read-only]
Cette propriété indique le nombre maximal de points de contact simultanés (doigts) pouvant être détectés.
pointerType : enumeration [read-only]
Cette propriété indique quel élément interagit avec l'PointerDevice.
Il existe une certaine redondance entre cette propriété et deviceType. Par exemple, si un écran tactile est utilisé, alors deviceType correspond à TouchScreen et pointerType correspond à Finger. Mais sur une tablette graphique, il est souvent possible d’utiliser les deux extrémités du stylet, et les programmes doivent les distinguer. PointerDeviceHandler::acceptedDevices et PointerDeviceHandler::acceptedPointerTypes peuvent être utilisées conjointement pour filtrer le sous-ensemble d’événements auxquels un gestionnaire particulier doit réagir.
Les valeurs valides sont :
| Constante | Description |
|---|---|
PointerDevice.Unknown | Le périphérique ne peut pas être identifié. |
PointerDevice.Generic | Une souris ou un périphérique émulant une souris. |
PointerDevice.Finger | Un doigt sur un écran tactile. |
PointerDevice.Pen | Un stylet sur une tablette graphique. |
PointerDevice.Eraser | Une gomme sur une tablette graphique. |
PointerDevice.Cursor | Un numériseur avec réticule, sur une tablette graphique. |
Voir également QPointingDevice::PointerType et PointerDeviceHandler::acceptedPointerTypes.
uniqueId : pointingDeviceUniqueId [read-only]
Cette propriété peut fournir un identifiant unique pour le périphérique, s'il est disponible. Par exemple, un stylet de tablette graphique peut disposer d'un numéro de série unique.
Voir également eventPoint et QEventPoint::uniqueId().
Documentation sur les signaux
grabChanged(QtObject grabber, enumeration transition, PointerEvent event, eventPoint point)
Ce signal est émis lorsque l'objet ` grabber ` obtient ou perd un accès exclusif ou passif à ` point ` pendant la transmission de ` event`. L'transition indique ce qui s'est produit, du point de vue de l'objet ` grabber `, qui peut être soit un ` Item `, soit un `Input Handler`.
Les valeurs valides pour ` transition ` sont :
| Constante | Description |
|---|---|
PointerDevice.GrabExclusive | L’ grabber a pris la responsabilité principale de la gestion de l’ point. |
PointerDevice.UngrabExclusive | L’ grabber a renoncé à son accès exclusif précédent. |
PointerDevice.CancelGrabExclusive | La prise exclusive de l'grabber a été reprise ou annulée. |
PointerDevice.GrabPassive | L'grabber a acquis une emprise passive afin de surveiller l'point. |
PointerDevice.UngrabPassive | L'grabber a renoncé à son acquisition passive précédente. |
PointerDevice.CancelGrabPassive | La saisie passive précédente s’est terminée de manière anormale. Remarque : une transition de saisie d’un objet à un autre génère deux signaux, l’un pour signaler qu’un objet a perdu sa saisie, et l’autre pour signaler la présence d’un autre élément effectuant la saisie. Dans les autres cas, lors d’une transition vers ou depuis un état sans saisie, un seul signal est émis. |
Remarque : le gestionnaire correspondant est onGrabChanged.
Voir également QPointerEvent::setExclusiveGrabber(), QPointerEvent::addPassiveGrabber(), QPointerEvent::removePassiveGrabber() et PointerHandler::grabChanged().
© 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.
