En esta página

QInputDevice Class

La clase QInputDevice describe un dispositivo del que procede un objeto de tipo ` QInputEvent `. Más información...

Cabecera: #include <QInputDevice>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Desde: Qt 6.0
Heredado de: QObject
Heredado por:

QPointingDevice

Tipos públicos

flags Capabilities
enum class Capability { None, Position, Area, Pressure, Velocity, …, All }
enum class DeviceType { Unknown, Mouse, TouchScreen, TouchPad, Stylus, …, AllDevices }
flags DeviceTypes

Propiedades

Funciones públicas

QInputDevice(QObject *parent = nullptr)
QInputDevice(const QString &name, qint64 id, QInputDevice::DeviceType type, const QString &seatName = QString(), QObject *parent = nullptr)
QRect availableVirtualGeometry() const
QInputDevice::Capabilities capabilities() const
bool hasCapability(QInputDevice::Capability capability) const
QString name() const
QString seatName() const
qint64 systemId() const
QInputDevice::DeviceType type() const

Señales

void availableVirtualGeometryChanged(QRect area)
void capabilitiesChanged(QInputDevice::Capabilities capabilities)

Miembros públicos estáticos

QList<const QInputDevice *> devices()
const QInputDevice *primaryKeyboard(const QString &seatName = QString())
(since 6.3) QStringList seatNames()

Funciones protegidas

QInputDevice(const QInputDevice &)
QInputDevice(QInputDevice &&)
QInputDevice &operator=(QInputDevice &&)
QInputDevice &operator=(const QInputDevice &)

Descripción detallada

Cada clase ` QInputEvent ` contiene un puntero `QInputDevice` que permite acceder a propiedades específicas del dispositivo, como el tipo, las capacidades y la posición. Es responsabilidad de la plataforma o de los complementos genéricos detectar, crear y registrar una instancia de esta clase correspondiente a cada dispositivo de entrada disponible, mediante QWindowSystemInterface::registerInputDevice(), antes de generar cualquier evento de entrada relacionado con dicho dispositivo.

Las aplicaciones no necesitan instanciar esta clase, pero pueden leer las instancias a las que apuntan ` QInputEvent::device()` y ` QInputDevice::devices()`.

Documentación de los tipos de miembros

enum class QInputDevice::Capability
flags QInputDevice::Capabilities

Indica qué tipo de información puede proporcionar el dispositivo de entrada o su controlador.

ConstanteValorDescripción
QInputDevice::Capability::None0No hay información disponible sobre las capacidades del dispositivo de entrada.
QInputDevice::Capability::Position0x0001Indica que hay información de posición disponible, lo que significa que la familia de funciones position() de los puntos táctiles devuelve puntos válidos.
QInputDevice::Capability::Area0x0002Indica que hay información disponible sobre el área táctil, lo que significa que la función ` QEventPoint::ellipseDiameters()` de los puntos táctiles devuelve valores válidos.
QInputDevice::Capability::Pressure0x0004Indica que hay información de presión disponible, lo que significa que « QEventPoint::pressure()» devuelve un valor válido.
QInputDevice::Capability::Velocity0x0008Indica que hay información de velocidad disponible, lo que significa que « QEventPoint::velocity()» devuelve un vector válido.
QInputDevice::Capability::NormalizedPosition0x0020Indica que la posición normalizada está disponible, lo que significa que la función QEventPoint::normalizedPosition() devuelve un valor válido.
QInputDevice::Capability::MouseEmulation0x0040Indica que el dispositivo sintetiza eventos del ratón.
QInputDevice::Capability::Scroll0x0100Indica que el dispositivo dispone de capacidad de desplazamiento.
QInputDevice::Capability::PixelScroll (since Qt 6.2)0x0080Indica que el dispositivo (normalmente un ` touchpad`) se desplaza con ` pixel precision`.
QInputDevice::Capability::Hover0x0200Indica que el dispositivo tiene capacidad de desplazamiento al pasar el cursor.
QInputDevice::Capability::Rotation0x0400Indica que hay información de « rotation » disponible.
QInputDevice::Capability::XTilt0x0800Indica que hay información de « tilt » disponible para el eje X.
QInputDevice::Capability::YTilt0x1000Indica que hay información de « tilt » disponible para el eje Y.
QInputDevice::Capability::TangentialPressure0x2000Indica que hay información sobre el « tangential pressure » disponible.
QInputDevice::Capability::ZPosition0x4000Indica que hay información de posición disponible para el « Z-axis ».
QInputDevice::Capability::All0x7FFFFFFF 

El tipo «Capabilities» es una definición de tipo para QFlags<Capability>. Almacena una combinación OR de valores de Capability.

enum class QInputDevice::DeviceType
flags QInputDevice::DeviceTypes

Esta enumeración representa el tipo de dispositivo que generó un « QPointerEvent ».

ConstanteValorDescripción
QInputDevice::DeviceType::Unknown0x0000No se puede identificar el dispositivo.
QInputDevice::DeviceType::Mouse0x0001Un ratón.
QInputDevice::DeviceType::TouchScreen0x0002En este tipo de dispositivo, la superficie táctil y la pantalla están integradas. Esto significa que la superficie y la pantalla suelen tener el mismo tamaño, de modo que existe una relación directa entre las posiciones físicas de los puntos táctiles y las coordenadas proporcionadas por ` QEventPoint`. Como resultado, Qt permite al usuario interactuar directamente con varios `QWidgets`, `QGraphicsItems` o elementos ` Qt Quick ` al mismo tiempo.
QInputDevice::DeviceType::TouchPad0x0004En este tipo de dispositivo, la superficie táctil está separada de la pantalla. No existe una relación directa entre la ubicación física del toque y las coordenadas en pantalla. En su lugar, estas se calculan en relación con la posición actual del ratón, y el usuario debe utilizar el panel táctil para mover este punto de referencia. A diferencia de las pantallas táctiles, Qt solo permite a los usuarios interactuar con un único QWidget o QGraphicsItem a la vez.
QInputDevice::DeviceType::Stylus0x0010Dispositivo similar a un lápiz que se utiliza en una tableta gráfica, como una tableta Wacom, o en una pantalla táctil que cuenta con una función independiente de detección del lápiz óptico.
QInputDevice::DeviceType::Airbrush0x0020Un lápiz óptico con una ruedecilla para ajustar el « tangentialPressure ».
QInputDevice::DeviceType::Puck0x0008Un dispositivo similar a un ratón plano con un círculo transparente que muestra una cruz.
QInputDevice::DeviceType::Keyboard0x1000Un teclado.
QInputDevice::DeviceType::AllDevices0x7FFFFFFFCualquiera de los anteriores (utilizado como valor de filtro por defecto).

El tipo DeviceTypes es una definición de tipo (typedef) para QFlags<DeviceType>. Almacena una combinación OR de valores de DeviceType.

Documentación de la propiedad

[read-only] availableVirtualGeometry : QRect

Esta propiedad define la zona del escritorio virtual a la que puede acceder este dispositivo.

Por ejemplo, un dispositivo de entrada de tipo « TouchScreen » (pantalla fija) está fijado en una única pantalla física y suele estar calibrado de modo que esta área coincida con QScreen::geometry(), mientras que un dispositivo de tipo « Mouse » (pantalla variable) suele poder acceder a todas las pantallas del escritorio virtual.

Alternativamente, una tableta gráfica Wacom puede configurarse de modo que se asigne a todas las pantallas, o solo a la pantalla en la que el usuario prefiera crear dibujos, o únicamente a la ventana en la que se realice el dibujo.

Un dispositivo Stylus integrado en una pantalla táctil puede estar físicamente limitado a dicha pantalla.

Si el rectángulo devuelto es « null », significa que este dispositivo puede acceder a todo el escritorio virtual.

Funciones de acceso:

QRect availableVirtualGeometry() const

Señal de notificación:

void availableVirtualGeometryChanged(QRect area)

[read-only] capabilities : Capabilities

Esta propiedad contiene las capacidades del dispositivo.

Funciones de acceso:

QInputDevice::Capabilities capabilities() const

Señal de notificación:

void capabilitiesChanged(QInputDevice::Capabilities capabilities)

[read-only] name : const QString

Esta propiedad contiene el nombre del dispositivo.

Funciones de acceso:

QString name() const

[read-only] seatName : const QString

Esta propiedad contiene el asiento asociado al dispositivo.

Funciones de acceso:

QString seatName() const

[read-only] systemId : const qint64

Esta propiedad contiene el identificador del sistema específico de la plataforma.

Funciones de acceso:

qint64 systemId() const

[read-only] type : const DeviceType

Esta propiedad indica el tipo de dispositivo

Funciones de acceso:

QInputDevice::DeviceType type() const

Documentación de las funciones de miembro

QInputDevice::QInputDevice(QObject *parent = nullptr)

Crea una nueva instancia de dispositivo de entrada no válida como elemento secundario de parent.

QInputDevice::QInputDevice(const QString &name, qint64 id, QInputDevice::DeviceType type, const QString &seatName = QString(), QObject *parent = nullptr)

Crea una nueva instancia de dispositivo de entrada. El valor « name » proporcionado suele ser el nombre del modelo asignado por el fabricante, si está disponible, o cualquier otro dato identificativo; « id » es un número específico de la plataforma que será único para cada dispositivo (por ejemplo, el ID de xinput en X11); « type » identifica el tipo de dispositivo. En los sistemas de ventanas capaces de gestionar entradas de varios usuarios o conjuntos de dispositivos de entrada al mismo tiempo (como Wayland o X11), seatName identifica el nombre del conjunto de dispositivos que se utilizarán conjuntamente. Si el dispositivo es un dispositivo secundario o esclavo (por ejemplo, uno de varios ratones que pueden turnarse para mover el «puntero principal»), el dispositivo maestro debe indicarse como parent.

El complemento de la plataforma crea, registra y sigue siendo propietario de cada instancia de dispositivo; normalmente, se debe especificar parent por motivos de gestión de memoria, incluso si no hay un dispositivo maestro para un dispositivo concreto.

Por defecto, capabilities() son None.

[protected delete] QInputDevice::QInputDevice(const QInputDevice &)

Crea una instancia de ` QInputDevice` mediante copia. Esta función ha sido eliminada.

[protected delete] QInputDevice::QInputDevice(QInputDevice &&)

Crea una instancia de ` QInputDevice`. Esta función se ha eliminado.

QInputDevice::Capabilities QInputDevice::capabilities() const

Devuelve las capacidades del dispositivo.

Nota: Funcióngetter para la propiedad capabilities.

[static] QList<const QInputDevice *> QInputDevice::devices()

Devuelve una lista de todos los dispositivos de entrada registrados (teclados y dispositivos señaladores).

Nota: La lista de dispositivos no siempre está completa en todas las plataformas. Hasta ahora, la información más completa está disponible en la plataforma Linux, tanto al inicio del sistema como en respuesta a la conexión en caliente. La mayoría de las demás plataformas solo pueden proporcionar dispositivos genéricos de diversos tipos, y solo después de recibir eventos de ellos; además, la mayoría de las plataformas no informan a Qt cuando se conecta un dispositivo, ni cuando se desconecta en tiempo de ejecución.

Nota: La lista devuelta no se puede utilizar para añadir nuevos dispositivos. Para añadir una pantalla táctil simulada para una autoprueba, se puede utilizar ` QTest::createTouchDevice()`. Los complementos de plataforma deben llamar a `QWindowSystemInterface::registerInputDevice()` para añadir dispositivos a medida que se detectan.

bool QInputDevice::hasCapability(QInputDevice::Capability capability) const

Devuelve si las capacidades del dispositivo incluyen el capability especificado.

QString QInputDevice::name() const

Devuelve el nombre del dispositivo.

Esta cadena puede estar vacía. Sin embargo, resulta útil en sistemas que cuentan con varios dispositivos de entrada: se puede utilizar para diferenciar de qué dispositivo procede un « QPointerEvent ».

Nota: Funcióngetter para la propiedad «name».

[static] const QInputDevice *QInputDevice::primaryKeyboard(const QString &seatName = QString())

Devuelve el teclado principal o maestro de la plaza indicada seatName.

QString QInputDevice::seatName() const

Devuelve el asiento al que está asociado el dispositivo, si se conoce; en caso contrario, devuelve un valor vacío.

Los dispositivos destinados a ser utilizados conjuntamente por un mismo usuario pueden configurarse para que tengan el mismo nombre de sesión. Por el momento, esto solo es posible en las plataformas Wayland y X11.

Nota: Funcióngetter para la propiedad seatName.

[static, since 6.3] QStringList QInputDevice::seatNames()

Devuelve una lista con los nombres de los dispositivos de entrada registrados (teclados y dispositivos señaladores).

Esta función se introdujo en Qt 6.3.

qint64 QInputDevice::systemId() const

Devuelve el identificador del sistema específico de la plataforma (por ejemplo, el identificador xinput en la plataforma X11).

Se espera que todas las plataformas proporcionen un identificador de sistema único para cada dispositivo.

Nota: Funcióngetter para la propiedad systemId.

QInputDevice::DeviceType QInputDevice::type() const

Devuelve el tipo de dispositivo.

Nota: Funcióngetter para la propiedad «type».

[protected delete] QInputDevice &QInputDevice::operator=(QInputDevice &&)

Asigna mediante «move» other a esta instancia de QInputDevice. Esta función se elimina.

[protected delete] QInputDevice &QInputDevice::operator=(const QInputDevice &)

Asigna por copia other a esta instancia de QInputDevice. 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.