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: |
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.
| Constante | Valor | Descripción |
|---|---|---|
QInputDevice::Capability::None | 0 | No hay información disponible sobre las capacidades del dispositivo de entrada. |
QInputDevice::Capability::Position | 0x0001 | Indica 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::Area | 0x0002 | Indica 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::Pressure | 0x0004 | Indica que hay información de presión disponible, lo que significa que « QEventPoint::pressure()» devuelve un valor válido. |
QInputDevice::Capability::Velocity | 0x0008 | Indica que hay información de velocidad disponible, lo que significa que « QEventPoint::velocity()» devuelve un vector válido. |
QInputDevice::Capability::NormalizedPosition | 0x0020 | Indica que la posición normalizada está disponible, lo que significa que la función QEventPoint::normalizedPosition() devuelve un valor válido. |
QInputDevice::Capability::MouseEmulation | 0x0040 | Indica que el dispositivo sintetiza eventos del ratón. |
QInputDevice::Capability::Scroll | 0x0100 | Indica que el dispositivo dispone de capacidad de desplazamiento. |
QInputDevice::Capability::PixelScroll (since Qt 6.2) | 0x0080 | Indica que el dispositivo (normalmente un ` touchpad`) se desplaza con ` pixel precision`. |
QInputDevice::Capability::Hover | 0x0200 | Indica que el dispositivo tiene capacidad de desplazamiento al pasar el cursor. |
QInputDevice::Capability::Rotation | 0x0400 | Indica que hay información de « rotation » disponible. |
QInputDevice::Capability::XTilt | 0x0800 | Indica que hay información de « tilt » disponible para el eje X. |
QInputDevice::Capability::YTilt | 0x1000 | Indica que hay información de « tilt » disponible para el eje Y. |
QInputDevice::Capability::TangentialPressure | 0x2000 | Indica que hay información sobre el « tangential pressure » disponible. |
QInputDevice::Capability::ZPosition | 0x4000 | Indica que hay información de posición disponible para el « Z-axis ». |
QInputDevice::Capability::All | 0x7FFFFFFF |
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 ».
| Constante | Valor | Descripción |
|---|---|---|
QInputDevice::DeviceType::Unknown | 0x0000 | No se puede identificar el dispositivo. |
QInputDevice::DeviceType::Mouse | 0x0001 | Un ratón. |
QInputDevice::DeviceType::TouchScreen | 0x0002 | En 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::TouchPad | 0x0004 | En 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::Stylus | 0x0010 | Dispositivo 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::Airbrush | 0x0020 | Un lápiz óptico con una ruedecilla para ajustar el « tangentialPressure ». |
QInputDevice::DeviceType::Puck | 0x0008 | Un dispositivo similar a un ratón plano con un círculo transparente que muestra una cruz. |
QInputDevice::DeviceType::Keyboard | 0x1000 | Un teclado. |
QInputDevice::DeviceType::AllDevices | 0x7FFFFFFF | Cualquiera 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.