QTabletEvent Class

Descripción Detallada

Loseventos de tableta son generados por periféricos de tableta como las tabletas Wacom y otras marcas, y dispositivos de lápiz electromagnético incluidos con algunos tipos de tabletas. (No es lo mismo que QTouchEvent que genera una pantalla táctil, incluso cuando se utiliza un lápiz óptico pasivo en una pantalla táctil).

Los eventos de tableta son similares a los eventos de ratón; por ejemplo, los accesorios x(), y(), pos(), globalX(), globalY() y globalPos() proporcionan la posición del cursor, y se puede ver qué buttons() se pulsan (pulsar la punta del lápiz contra la superficie de la tableta equivale a un botón izquierdo del ratón). Pero los eventos de la tableta también pasan a través de alguna información extra que proporciona el controlador del dispositivo de la tableta; por ejemplo, es posible que desee hacer 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 contra la superficie de la tableta, utilizar diferentes pinceles en función del tipo de herramienta en uso (deviceType()), modular de algún modo la forma del pincel en función de 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 una bandera de aceptación que indica si el receptor quiere el evento. Debes llamar a QTabletEvent::accept() si manejas el evento de la tableta; de lo contrario, se enviará al widget padre. La excepción son los eventos TabletEnterProximity y TabletLeaveProximity: éstos sólo se envían a QApplication y no se comprueba si son aceptados o no.

La función QWidget::setEnabled() puede utilizarse para activar o desactivar los eventos de ratón, tableta y teclado de un widget.

El manejador de eventos QWidget::tabletEvent() recibe eventos TabletPress, TabletRelease y TabletMove. Qt enviará primero un evento de tableta, luego si no es aceptado por ningún widget, enviará un evento de ratón. Esto permite a los usuarios de aplicaciones que no están diseñadas para tabletas utilizar una tableta como un ratón. Sin embargo, las aplicaciones de dibujo de alta resolución deberían manejar los eventos de tableta, ya que pueden producirse con mayor frecuencia, lo que supone una ventaja para un dibujo suave y preciso. Si se rechazan los eventos de la tableta, se pueden comprimir los eventos sintéticos del ratón para mayor eficacia.

Tenga en cuenta que pulsar el botón del lápiz óptico mientras éste pasa por encima de la tableta generará una pulsación de botón en algunos tipos de tabletas, mientras que en otros tipos será necesario presionar el lápiz óptico contra la superficie de la tableta para registrar la pulsación simultánea del botón del lápiz óptico.

Notas para usuarios de X11

Si la tableta está configurada en xorg.conf para usar el controlador Wacom, habrá "dispositivos" XInput separados para el stylus, el borrador, y (opcionalmente) el cursor y el touchpad. Qt los reconoce por sus nombres. De lo contrario, si la tableta está configurada para utilizar el controlador evdev, sólo habrá un dispositivo y las aplicaciones pueden no ser capaces de distinguir el lápiz óptico de la goma de borrar.

Notas para usuarios de Windows

La compatibilidad con tabletas requiere actualmente la instalación del controlador WACOM para Windows que proporciona la DLL wintab32.dll. Está contenido en paquetes más antiguos, por ejemplo pentablet_5.3.5-3.exe.