QTabletEvent Class
La clase QTabletEvent contiene parámetros que describen un evento de Tablet. Más información...
| Cabecera: | #include <QTabletEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado de: | QSinglePointEvent |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QTabletEvent forma parte de las clases de eventos.
Funciones públicas
| QTabletEvent(QEvent::Type type, const QPointingDevice *dev, const QPointF &pos, const QPointF &globalPos, qreal pressure, float xTilt, float yTilt, float tangentialPressure, qreal rotation, float z, Qt::KeyboardModifiers keyState, Qt::MouseButton button, Qt::MouseButtons buttons) | |
| qreal | pressure() const |
| qreal | rotation() const |
| qreal | tangentialPressure() const |
| qreal | xTilt() const |
| qreal | yTilt() const |
| qreal | z() const |
Funciones protegidas
| QTabletEvent(QTabletEvent &&) | |
| QTabletEvent & | operator=(QTabletEvent &&) |
| QTabletEvent & | operator=(const QTabletEvent &other) |
Descripción detallada
Los eventos de tableta se generan a partir de periféricos de tableta, como las tabletas Wacom y otras marcas diversas, así como de dispositivos de lápiz electromagnético incluidos en algunos tipos de ordenadores tablet. (No es lo mismo que el evento « QTouchEvent » que genera una pantalla táctil, incluso cuando se utiliza un lápiz pasivo en una pantalla táctil).
Los eventos de tableta son similares a los eventos de ratón; por ejemplo, los accesores x(), y(), pos(), globalX(), globalY() y globalPos() proporcionan la posición del cursor, y permiten ver qué teclas buttons() están pulsadas (presionar la punta del lápiz contra la superficie de la tableta equivale a pulsar el botón izquierdo del ratón). Sin embargo, los eventos de la tableta también transmiten información adicional que proporciona el controlador del dispositivo; por ejemplo, es posible que desees realizar un renderizado de subpíxeles con coordenadas de mayor resolución (globalPosF()), ajustar el brillo del color en función de la pressure() de la herramienta respecto a la superficie de la tableta, utilizar diferentes pinceles según el tipo de herramienta que se esté utilizando (deviceType()), modular la forma del pincel de alguna manera según la inclinación de los ejes X e Y de la herramienta con respecto a la superficie de la tableta (xTilt() y yTilt()), y utilizar un borrador virtual en lugar de un pincel si el usuario cambia al otro extremo de un lápiz de doble punta (pointerType()).
Cada evento contiene un indicador de aceptación que señala si el receptor desea recibir el evento. Debe llamar a QTabletEvent::accept() si gestiona el evento de la tableta; de lo contrario, se enviará al widget padre. La excepción la constituyen los eventos TabletEnterProximity y TabletLeaveProximity: estos solo se envían a QApplication y no comprueban si se aceptan o no.
La función QWidget::setEnabled() se puede utilizar para habilitar o deshabilitar los eventos de ratón, tableta y teclado para un widget.
El controlador de eventos QWidget::tabletEvent() recibe los eventos TabletPress, TabletRelease y TabletMove. Qt enviará primero un evento de tableta y, si ningún widget lo acepta, enviará un evento de ratón. Esto permite a los usuarios de aplicaciones que no están diseñadas para tabletas utilizar la tableta como si fuera un ratón. Sin embargo, las aplicaciones de dibujo de alta resolución deberían gestionar los eventos de tableta, ya que pueden producirse con mayor frecuencia, lo que supone una ventaja para un dibujo fluido y preciso. Si se rechazan los eventos de tableta, los eventos sintéticos del ratón pueden comprimirse en aras de la eficiencia.
Ten en cuenta que pulsar el botón del lápiz mientras este se encuentra suspendido sobre la tableta generará una pulsación de botón en algunos tipos de tabletas, mientras que en otros será necesario presionar el lápiz contra la superficie de la tableta para que se registre la pulsación simultánea del botón del lápiz.
Notas para usuarios de X11
Si la tableta está configurada en xorg.conf para utilizar el controlador Wacom, habrá «dispositivos» XInput independientes para el lápiz, el borrador y (opcionalmente) el cursor y el panel táctil. Qt los reconoce por sus nombres. Por el contrario, si la tableta está configurada para utilizar el controlador evdev, solo habrá un dispositivo y es posible que las aplicaciones no puedan distinguir el lápiz del borrador.
Notas para usuarios de Windows
Actualmente, la compatibilidad con la tableta requiere que esté instalado el controlador de Wacom para Windows que proporciona la DLL wintab32.dll. Se incluye en paquetes más antiguos, por ejemplo, pentablet_5.3.5-3.exe.
Documentación de las funciones de miembro
QTabletEvent::QTabletEvent(QEvent::Type type, const QPointingDevice *dev, const QPointF &pos, const QPointF &globalPos, qreal pressure, float xTilt, float yTilt, float tangentialPressure, qreal rotation, float z, Qt::KeyboardModifiers keyState, Qt::MouseButton button, Qt::MouseButtons buttons)
Crea un evento de tableta a partir del type dado.
El parámetro « pos » indica dónde se produjo el evento en el widget; « globalPos » es la posición correspondiente en coordenadas absolutas.
pressure dev indica la presión ejercida sobre el dispositivo.
xTilt y yTilt indican el grado de inclinación del dispositivo respecto a los ejes x e y, respectivamente.
keyState especifica qué teclas modificadoras del teclado están pulsadas (p. ej., Ctrl).
El parámetro « z » proporciona la coordenada Z del dispositivo en la tableta; normalmente la proporciona la rueda de un ratón 4D. Si el dispositivo no admite el eje Z (es decir, si « QPointingDevice::capabilities()» no incluye « ZPosition »), pasa aquí « 0 ».
El parámetro « tangentialPressure » proporciona el valor de presión tangencial de la ruedecilla de un aerógrafo. Si el dispositivo no admite presión tangencial (es decir, QPointingDevice::capabilities() no incluye TangentialPressure), pasa 0 aquí.
rotation Proporciona la rotación del dispositivo en grados. Los ratones 4D, el Wacom Art Pen y el Apple Pencil admiten la rotación. Si el dispositivo no admite la rotación (es decir, si QPointingDevice::capabilities() no incluye Rotation), pasa aquí 0.
El button que ha provocado el evento se indica como un valor de la enumeración Qt::MouseButton. Si el evento type no es TabletPress ni TabletRelease, el botón correspondiente a este evento es Qt::NoButton.
buttons es el estado de todos los botones en el momento del evento.
Véase también pos(), globalPos(), device(), pressure(), xTilt(), yTilt(), uniqueId(), rotation(), tangentialPressure() y z().
[protected delete] QTabletEvent::QTabletEvent(QTabletEvent &&)
Crea una instancia de ` QTabletEvent`. Esta función se ha eliminado.
qreal QTabletEvent::pressure() const
Devuelve la presión del dispositivo. 0,0 indica que el lápiz no está sobre la tableta; 1,0 indica la presión máxima del lápiz.
Véase también tangentialPressure().
qreal QTabletEvent::rotation() const
Devuelve la rotación de la herramienta actual en grados, donde el valor cero indica que la punta del lápiz apunta hacia la parte superior de la tableta, un valor positivo indica que está girada hacia la derecha y un valor negativo indica que está girada hacia la izquierda. Este valor puede obtenerse mediante un ratón 4D o un lápiz con capacidad de rotación (como el Wacom Art Pen o el Apple Pencil). Si el dispositivo no admite la rotación, este valor es siempre 0,0.
qreal QTabletEvent::tangentialPressure() const
Devuelve la presión tangencial del dispositivo. Normalmente se ajusta mediante una ruedecilla situada en un aerógrafo. El rango va de -1,0 a 1,0. El valor 0,0 indica la posición neutra. Los aerógrafos actuales solo pueden moverse en dirección positiva desde la posición neutra. Si el dispositivo no admite presión tangencial, este valor es siempre 0,0.
Nota: El valor se almacena como un número flotante de precisión simple.
Véase también pressure().
qreal QTabletEvent::xTilt() const
Devuelve el ángulo entre el dispositivo (por ejemplo, un lápiz) y la perpendicular en la dirección del eje x. Los valores positivos indican hacia la derecha física de la tableta. El ángulo está comprendido entre -60 y +60 grados.

Nota: El valor se almacena como un número flotante de precisión simple.
Véase también yTilt().
qreal QTabletEvent::yTilt() const
Devuelve el ángulo entre el dispositivo (por ejemplo, un lápiz) y la perpendicular en la dirección del eje y. Los valores positivos indican la dirección hacia la parte inferior de la tableta. El ángulo está comprendido entre -60 y +60 grados.
Nota: El valor se almacena como un número flotante de precisión simple.
Véase también xTilt().
qreal QTabletEvent::z() const
Devuelve la posición en el eje Z del dispositivo. Normalmente, en un ratón 4D, esto se representa mediante una ruedecilla. Si el dispositivo no admite el eje Z, este valor es siempre cero. No debe confundirse con la presión.
Nota: El valor se almacena como un número flotante de precisión simple.
Véase también pressure().
[protected delete] QTabletEvent &QTabletEvent::operator=(QTabletEvent &&)
Asigna mediante «move» other a esta instancia de QTabletEvent. Esta función se elimina.
[noexcept protected default] QTabletEvent &QTabletEvent::operator=(const QTabletEvent &other)
Asigna por copia other a esta instancia de QTabletEvent.
© 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.