PointerDevice QML Type
Équivalent QML de QPointingDevice. Plus d'informations...
| 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 les mêmes enums que la classe QPointingDevice.
Documentation sur les propriétés
buttonCount : int [read-only]
Cette propriété indique le nombre maximum de boutons sur l'appareil qui peuvent être détectés.
deviceType : enumeration
Cette propriété indique le type d'appareil qui a généré un PointerEvent.
Les valeurs valides sont les suivantes :
| Constante | Description |
|---|---|
PointerDevice.Unknown | Le périphérique ne peut ê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 un réticule, sur une tablette graphique. |
Voir également QInputDevice::DeviceType et PointerDeviceHandler::acceptedDevices.
maximumPoints : int [read-only]
Cette propriété indique le nombre maximum de points de contact simultanés (doigts) qui peuvent être détectés.
pointerType : enumeration [read-only]
Cette propriété indique ce qui interagit avec PointerDevice.
Il existe une certaine redondance entre cette propriété et deviceType. Par exemple, si un écran tactile est utilisé, alors deviceType est TouchScreen et pointerType est Finger. Mais sur une tablette graphique, il est souvent possible que les deux extrémités du stylet soient utilisées, et les programmes doivent les distinguer. PointerDeviceHandler::acceptedDevices et PointerDeviceHandler::acceptedPointerTypes peuvent être utilisés en combinaison pour filtrer le sous-ensemble d'événements auxquels un gestionnaire particulier doit réagir.
Les valeurs valides sont les suivantes
| Constante | Description |
|---|---|
PointerDevice.Unknown | Le périphérique ne peut pas être identifié. |
PointerDevice.Generic | Une souris ou un dispositif é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 un 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 dispositif, s'il est disponible. Par exemple, un stylet de tablette graphique peut avoir 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 une prise exclusive ou passive de point pendant la livraison de event. transition indique ce qui s'est passé, du point de vue de l'objet grabber, qui peut être soit Item, soit un gestionnaire d'entrée.
Les valeurs valables pour transition sont les suivantes
| Constante | Description de l'objet |
|---|---|
PointerDevice.GrabExclusive | L'objet grabber a pris la responsabilité principale du traitement de l'objet point. |
PointerDevice.UngrabExclusive | L'objet grabber a renoncé à l'exclusivité qu'il détenait jusqu'à présent. |
PointerDevice.CancelGrabExclusive | La prise exclusive de grabber a été reprise ou annulée. |
PointerDevice.GrabPassive | Le site grabber a acquis une prise passive pour surveiller le site point. |
PointerDevice.UngrabPassive | Le grabber a abandonné son précédent grab passif. |
PointerDevice.CancelGrabPassive | La prise passive précédente s'est terminée de manière anormale. |
Remarque : le passage d'une prise d'un objet à un autre donne lieu à deux signaux, l'un indiquant qu'un objet a perdu sa prise, l'autre indiquant qu'il y a une autre prise. Dans les autres cas, lors d'une transition vers ou depuis un état de non-prise, 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.
