PointerDevice QML Type
Equivalente de QML para QPointingDevice. Más...
| Import Statement: | import QtQuick |
| In C++: | QPointingDevice |
Propiedades
- buttonCount : int
- deviceType : enumeration
- maximumPoints : int
- pointerType : enumeration
- uniqueId : pointingDeviceUniqueId
Señales
- grabChanged(QtObject grabber, enumeration transition, PointerEvent event, eventPoint point)
Descripción detallada
PointerDevice es el nombre QML de la clase QPointingDevice. Tiene las mismas propiedades y enums que QPointingDevice.
Documentación de propiedades
buttonCount : int [read-only]
Esta propiedad indica el número máximo de botones en el dispositivo que se pueden detectar.
deviceType : enumeration
Esta propiedad indica el tipo de dispositivo que ha generado un PointerEvent.
Los valores válidos son:
| Constante | Descripción |
|---|---|
PointerDevice.Unknown | No se puede identificar el dispositivo. |
PointerDevice.Mouse | Un ratón. |
PointerDevice.TouchScreen | Una pantalla táctil. |
PointerDevice.TouchPad | Un touchpad o trackpad. |
PointerDevice.Stylus | Un lápiz sobre una tableta gráfica. |
PointerDevice.Airbrush | Un aerógrafo en una tableta gráfica. |
PointerDevice.Puck | Un digitalizador con retícula, en una tableta gráfica. |
Véase también QInputDevice::DeviceType y PointerDeviceHandler::acceptedDevices.
maximumPoints : int [read-only]
Esta propiedad indica el número máximo de puntos táctiles simultáneos (dedos) que se pueden detectar.
pointerType : enumeration [read-only]
Esta propiedad indica qué está interactuando con PointerDevice.
Existe cierta redundancia entre esta propiedad y deviceType. Por ejemplo, si se utiliza una pantalla táctil, entonces deviceType es TouchScreen y pointerType es Finger. Pero en una tableta gráfica, a menudo es posible que se utilicen ambos extremos del lápiz óptico, y los programas necesitan distinguirlos. PointerDeviceHandler::acceptedDevices y PointerDeviceHandler::acceptedPointerTypes pueden utilizarse en combinación para filtrar el subconjunto de eventos a los que debe reaccionar un manejador concreto.
Los valores válidos son:
| Constante | Descripción |
|---|---|
PointerDevice.Unknown | No se puede identificar el dispositivo. |
PointerDevice.Generic | Un ratón o un dispositivo que emula un ratón. |
PointerDevice.Finger | Un dedo en una pantalla táctil. |
PointerDevice.Pen | Un lápiz sobre una tableta gráfica. |
PointerDevice.Eraser | Un borrador en una tableta gráfica. |
PointerDevice.Cursor | Un digitalizador con retícula, en una tableta gráfica. |
Véase también QPointingDevice::PointerType y PointerDeviceHandler::acceptedPointerTypes.
uniqueId : pointingDeviceUniqueId [read-only]
Esta propiedad puede proporcionar un ID único para el dispositivo, si está disponible. Por ejemplo, un dispositivo stylus de tableta gráfica puede tener un número de serie único.
Véase también eventPoint y QEventPoint::uniqueId().
Documentación sobre señales
grabChanged(QtObject grabber, enumeration transition, PointerEvent event, eventPoint point)
Esta señal se emite cuando el objeto grabber gana o pierde un agarre exclusivo o pasivo de point durante la entrega de event. transition informa de lo sucedido, desde la perspectiva del objeto grabber, que puede ser un Item o un Input Handler.
Los valores válidos para transition son:
| Constante | Descripción |
|---|---|
PointerDevice.GrabExclusive | El grabber ha asumido la responsabilidad principal de gestionar el point. |
PointerDevice.UngrabExclusive | El grabber ha renunciado a su captura exclusiva anterior. |
PointerDevice.CancelGrabExclusive | La captura exclusiva de grabber ha sido asumida o cancelada. |
PointerDevice.GrabPassive | El grabber ha adquirido una cuchara pasiva, para controlar el point. |
PointerDevice.UngrabPassive | El grabber ha renunciado a su captura pasiva anterior. |
PointerDevice.CancelGrabPassive | La toma pasiva anterior ha finalizado de forma anormal. |
Nota: Una transición de agarre de un objeto a otro da lugar a dos señales, para notificar que un objeto ha perdido su agarre, y para notificar que hay otro agarrador. En otros casos, cuando se produce una transición hacia o desde un estado de no agarre, sólo se emite una señal.
Nota: El manejador correspondiente es onGrabChanged.
Véase también QPointerEvent::setExclusiveGrabber(), QPointerEvent::addPassiveGrabber(), QPointerEvent::removePassiveGrabber(), y 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.
