QPointingDevice Class
La clase QPointingDevice describe un dispositivo del que proceden los eventos de ratón, táctiles o de tableta. Más información...
| Encabezado: | #include <QPointingDevice> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Desde: | Qt 6.0 |
| Heredado de: | QInputDevice |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QPointingDevice forma parte de las clases de eventos.
Tipos públicos
| enum | GrabTransition { GrabExclusive, UngrabExclusive, CancelGrabExclusive, GrabPassive, UngrabPassive, …, OverrideGrabPassive } |
| enum class | PointerType { Unknown, Generic, Finger, Pen, Eraser, …, AllPointerTypes } |
| flags | PointerTypes |
Propiedades
- buttonCount : const int
- maximumPoints : const int
- pointerType : const PointerType
- uniqueId : const QPointingDeviceUniqueId
Funciones públicas
| QPointingDevice(QObject *parent = nullptr) | |
| QPointingDevice(const QString &name, qint64 id, QInputDevice::DeviceType deviceType, QPointingDevice::PointerType pointerType, QInputDevice::Capabilities capabilities, int maxPoints, int buttonCount, const QString &seatName = QString(), QPointingDeviceUniqueId uniqueId = QPointingDeviceUniqueId(), QObject *parent = nullptr) | |
| int | buttonCount() const |
| int | maximumPoints() const |
| QPointingDevice::PointerType | pointerType() const |
| QPointingDeviceUniqueId | uniqueId() const |
Señales
| void | grabChanged(QObject *grabber, QPointingDevice::GrabTransition transition, const QPointerEvent *event, const QEventPoint &point) const |
Miembros públicos estáticos
| const QPointingDevice * | primaryPointingDevice(const QString &seatName = QString()) |
Funciones protegidas
| QPointingDevice(const QPointingDevice &) | |
| QPointingDevice(QPointingDevice &&) | |
| QPointingDevice & | operator=(QPointingDevice &&) |
| QPointingDevice & | operator=(const QPointingDevice &) |
Descripción detallada
Cada objeto ` QPointerEvent ` contiene un puntero `QPointingDevice` que permite acceder a propiedades específicas del dispositivo, como el tipo y las capacidades. Es responsabilidad de la plataforma o de los complementos genéricos registrar los dispositivos de puntero disponibles a través de `QWindowSystemInterface` antes de generar cualquier evento de puntero. Las aplicaciones no necesitan instanciar esta clase, sino que deben acceder a las instancias globales a las que apunta ` QPointerEvent::device()`.
Documentación sobre los tipos de miembros
enum QPointingDevice::GrabTransition
Esta enumeración representa una transición de una adquisición exclusiva o pasiva de un objeto (posiblemente nullptr) a otro (posiblemente nullptr). Se emite como argumento de la señal QPointingDevice::grabChanged().
Los valores válidos son:
| Constante | Valor | Descripción |
|---|---|---|
QPointingDevice::GrabExclusive | 0x10 | Se emite tras QPointerEvent::setExclusiveGrabber(). |
QPointingDevice::UngrabExclusive | 0x20 | Se emite tras QPointerEvent::setExclusiveGrabber() cuando el «grabber» está configurado en nullptr, para notificar que la captura ha finalizado con normalidad. |
QPointingDevice::CancelGrabExclusive | 0x30 | Se emite tras QPointerEvent::setExclusiveGrabber() cuando el «grabber» se establece en un objeto diferente, para notificar que la captura del antiguo «grabber» ha sido «robada». |
QPointingDevice::GrabPassive | 0x01 | Se emite tras QPointerEvent::addPassiveGrabber(). |
QPointingDevice::UngrabPassive | 0x02 | Se emite cuando una sujeción pasiva finaliza de forma normal, por ejemplo, tras llamar a ` QPointerEvent::removePassiveGrabber()`. |
QPointingDevice::CancelGrabPassive | 0x03 | Se emite cuando una sujeción pasiva finaliza de forma anómala (se cancela un gesto). |
QPointingDevice::OverrideGrabPassive | 0x04 | Este valor no se utiliza actualmente. |
enum class QPointingDevice::PointerType
flags QPointingDevice::PointerTypes
Esta enumeración representa qué elemento está interactuando con el dispositivo señalador.
Existe cierta redundancia entre esta propiedad y « QInputDevice::DeviceType ». Por ejemplo, si se utiliza una pantalla táctil, « DeviceType » es « TouchScreen » y « PointerType » es « Finger » (siempre). Sin embargo, en una tableta gráfica, a menudo es posible utilizar ambos extremos del lápiz óptico, y los programas necesitan distinguirlos. Por lo tanto, el concepto se amplía de modo que cada objeto ` QPointerEvent ` tenga un `PointerType`, lo que puede simplificar parte del código de gestión de eventos al ignorar el `DeviceType` y reaccionar de forma diferente en función únicamente del `PointerType`.
Los valores válidos son:
| Constante | Valor | Descripción |
|---|---|---|
QPointingDevice::PointerType::Unknown | 0 | Se desconoce el tipo de puntero. |
QPointingDevice::PointerType::Generic | 0x0001 | Un ratón o algo que actúe como un ratón (el puntero principal en X11). |
QPointingDevice::PointerType::Finger | 0x0002 | El dedo del usuario. |
QPointingDevice::PointerType::Pen | 0x0004 | La punta de dibujo de un lápiz óptico. |
QPointingDevice::PointerType::Eraser | 0x0008 | El otro extremo del lápiz óptico (si tiene un borrador virtual en el otro extremo). |
QPointingDevice::PointerType::Cursor | 0x0010 | Un círculo transparente con retícula, como el que se encuentra en un dispositivo « Puck ». |
QPointingDevice::PointerType::Palm (since Qt 6.12) | 0x0020 | La palma de la mano del usuario. |
QPointingDevice::PointerType::AllPointerTypes | 0x7FFF | Cualquiera de los anteriores (utilizado como valor de filtro por defecto). |
El tipo `PointerTypes` es una definición de tipo (`typedef`) para ` QFlags<PointerType>`. Almacena una combinación OR de valores de `PointerType`.
Documentación de la propiedad
[read-only] buttonCount : const int
Esta propiedad indica el número máximo de botones del dispositivo que se pueden detectar
Funciones de acceso:
| int | buttonCount() const |
[read-only] maximumPoints : const int
Esta propiedad indica el número máximo de puntos táctiles simultáneos (dedos) que se pueden detectar
Funciones de acceso:
| int | maximumPoints() const |
[read-only] pointerType : const PointerType
Esta propiedad contiene el tipo de puntero
Funciones de acceso:
| QPointingDevice::PointerType | pointerType() const |
[read-only] uniqueId : const QPointingDeviceUniqueId
Esta propiedad contiene un identificador único (de utilidad dudosa) para el dispositivo
Probablemente te convenga más centrarte en QPointerEventPoint::uniqueId().
Funciones de acceso:
| QPointingDeviceUniqueId | uniqueId() const |
Documentación de las funciones de miembro
QPointingDevice::QPointingDevice(QObject *parent = nullptr)
Crea una nueva instancia de dispositivo de puntero no válido como elemento secundario de ` parent`.
QPointingDevice::QPointingDevice(const QString &name, qint64 id, QInputDevice::DeviceType deviceType, QPointingDevice::PointerType pointerType, QInputDevice::Capabilities capabilities, int maxPoints, int buttonCount, const QString &seatName = QString(), QPointingDeviceUniqueId uniqueId = QPointingDeviceUniqueId(), QObject *parent = nullptr)
Crea una nueva instancia de dispositivo señalador con los siguientes valores: name, deviceType, pointerType, capabilities, maxPoints, buttonCount, seatName, uniqueId y parent.
[protected delete] QPointingDevice::QPointingDevice(const QPointingDevice &)
Crea una instancia de ` QPointingDevice` mediante copia. Esta función se ha eliminado.
[protected delete] QPointingDevice::QPointingDevice(QPointingDevice &&)
Crea una instancia de ` QPointingDevice`. Esta función se ha eliminado.
int QPointingDevice::buttonCount() const
Devuelve el número máximo de botones del dispositivo que se pueden detectar.
Nota: Funcióngetter para la propiedad buttonCount.
[signal] void QPointingDevice::grabChanged(QObject *grabber, QPointingDevice::GrabTransition transition, const QPointerEvent *event, const QEventPoint &point) const
Esta señal se emite cuando el objeto « grabber » obtiene o pierde un control exclusivo o pasivo sobre « point » durante la entrega de « event ». El « transition » indica lo que ha ocurrido, desde la perspectiva del objeto « grabber ».
Nota: Una transición de control de un objeto a otro da lugar a dos señales: una para notificar que un objeto ha perdido su control y otra para notificar que hay otro controlador. En otros casos, al pasar a un estado sin control o al salir de él, solo se emite una señal: el argumento grabber nunca es nullptr.
Véanse también QPointerEvent::setExclusiveGrabber(), QPointerEvent::addPassiveGrabber() y QPointerEvent::removePassiveGrabber().
int QPointingDevice::maximumPoints() const
Devuelve el número máximo de puntos de contacto simultáneos (dedos) que se pueden detectar.
Nota: Funcióngetter para la propiedad maximumPoints.
QPointingDevice::PointerType QPointingDevice::pointerType() const
Devuelve el tipo del puntero.
Nota: Funciónde lectura para la propiedad pointerType.
[static] const QPointingDevice *QPointingDevice::primaryPointingDevice(const QString &seatName = QString())
Devuelve el dispositivo de puntero principal (el puntero principal, que tradicionalmente se supone que es un ratón) en el asiento indicado seatName.
Si hay varios dispositivos de puntero registrados, esta función da preferencia a un ratón o a un panel táctil que coincida con el seatName dado y que no tenga otro dispositivo como padre. Normalmente, solo un dispositivo maestro o principal carece de dispositivo padre. Pero si no se encuentra dicho dispositivo, esta función crea un nuevo ratón virtual «puntero principal». De este modo, Qt sigue funcionando en plataformas que aún no realizan la detección y el registro de dispositivos de entrada.
QPointingDeviceUniqueId QPointingDevice::uniqueId() const
Devuelve un identificador único (de utilidad dudosa) para el dispositivo.
Probablemente deberías centrarte más bien en QPointerEventPoint::uniqueId().
Nota: Funcióngetter para la propiedad uniqueId.
[protected delete] QPointingDevice &QPointingDevice::operator=(QPointingDevice &&)
Asigna mediante «move» other a esta instancia de QPointingDevice. Esta función se elimina.
[protected delete] QPointingDevice &QPointingDevice::operator=(const QPointingDevice &)
Asigna por copia other a esta instancia de QPointingDevice. Esta función se ha eliminado.
© 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.