En esta página

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

Tipos públicos

enum GrabTransition { GrabExclusive, UngrabExclusive, CancelGrabExclusive, GrabPassive, UngrabPassive, …, OverrideGrabPassive }
enum class PointerType { Unknown, Generic, Finger, Pen, Eraser, …, AllPointerTypes }
flags PointerTypes

Propiedades

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:

ConstanteValorDescripción
QPointingDevice::GrabExclusive0x10Se emite tras QPointerEvent::setExclusiveGrabber().
QPointingDevice::UngrabExclusive0x20Se emite tras QPointerEvent::setExclusiveGrabber() cuando el «grabber» está configurado en nullptr, para notificar que la captura ha finalizado con normalidad.
QPointingDevice::CancelGrabExclusive0x30Se 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::GrabPassive0x01Se emite tras QPointerEvent::addPassiveGrabber().
QPointingDevice::UngrabPassive0x02Se emite cuando una sujeción pasiva finaliza de forma normal, por ejemplo, tras llamar a ` QPointerEvent::removePassiveGrabber()`.
QPointingDevice::CancelGrabPassive0x03Se emite cuando una sujeción pasiva finaliza de forma anómala (se cancela un gesto).
QPointingDevice::OverrideGrabPassive0x04Este 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:

ConstanteValorDescripción
QPointingDevice::PointerType::Unknown0Se desconoce el tipo de puntero.
QPointingDevice::PointerType::Generic0x0001Un ratón o algo que actúe como un ratón (el puntero principal en X11).
QPointingDevice::PointerType::Finger0x0002El dedo del usuario.
QPointingDevice::PointerType::Pen0x0004La punta de dibujo de un lápiz óptico.
QPointingDevice::PointerType::Eraser0x0008El otro extremo del lápiz óptico (si tiene un borrador virtual en el otro extremo).
QPointingDevice::PointerType::Cursor0x0010Un círculo transparente con retícula, como el que se encuentra en un dispositivo « Puck ».
QPointingDevice::PointerType::Palm (since Qt 6.12)0x0020La palma de la mano del usuario.
QPointingDevice::PointerType::AllPointerTypes0x7FFFCualquiera 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.