QTabletEvent

La classe QTabletEvent contient des paramètres qui décrivent un événement provenant d'une tablette. Plus d'informations...

#include <QTabletEvent>

Voir la position dans l'arbre des classes.

Héritage

Hérite de QInputEvent.

Description détaillée

La classe QTabletEvent contient des paramètres qui décrivent un événement provenant d'une tablette.

Les événements de tablette sont générés depuis une tablette Wacom. La plupart du temps vous allez vouloir gérer les événements venant d'une tablette comme s'ils venaient d'une souris ; par exemple, vous allez récupérer la position du curseur avec x(), y(), pos(), globalX(), globalY() et globalPos(). Dans certaines situations vous pouvez souhaiter récupérer des informations supplémentaires fournies par le pilote de la tablette ; par exemple, vous voulez faire du sous-pixelage avec des coordonnées haute résolution ou vous voulez ajuster l'intensité en vous basant sur la pression. QTabletEvent vous permet de lire la pression avec pressure(), l'inclinaison avec xTilt() et yTilt(), ainsi que le type de périphérique utilisé avec device() (voir TabletDevice). La classe peut aussi vous donner les valeurs minimale et maximale pour la pression ou les coordonnées haute résolution pour chaque périphérique.

Un événement de tablette contient un indicateur spécial qui indique si le receveur veut l'événement. Vous devez appeler QTabletEvent::accept() si vous prenez en charge l'événement de la tablette ; sinon il va être envoyé au widget parent. Les exceptions sont les événements TabletEnterProximity et TabletLeaveProximity, qui sont seulement envoyés à QApplication et il n'est pas vérifié s'ils sont acceptés ou refusés.

La fonction QWidget::setEnabled() peut être utilisée pour activer ou désactiver les événements de la souris et du clavier pour un widget.

Le gestionnaire d'événements QWidget::tabletEvent() reçoit les trois types d'événements tablette. Premièrement, Qt va envoyer un tabletEvent puis, s'il n'est pas accepté, un événement de souris. Cela permet aux applications qui ne prennent pas en charge les tablettes, d'utiliser la tablette comme une souris, ainsi que de permettre l'utilisation de souris et de tablettes de manière différente.

Notes pour les utilisateurs de X11

Qt utilise les noms, écrits en dur, suivant pour identifier les tablettes dans le fichier xorg.conf sur X11 (sauf pour IRIX) : ‹stylus›, ‹pen› et ‹eraser›. Si le périphérique a un autre nom alors Qt ne l'utilisera pas.

Type

enum QTabletEvent::PointerType

Cette enum définit quel type de pointe génère l'événement.

Voir aussi pointerType().

enum QTabletEvent::TabletDevice

Cet enum définit le type de périphérique qui génère l'événement.

Cette enum a été introduite ou modifiée dans Qt 4.1.

Fonctions membres

QTabletEvent::QTabletEvent ( Type type, const QPoint & pos, const QPoint & globalPos, const QPointF & hiResGlobalPos, int device, int pointerType, qreal pressure, int xTilt, int yTilt, qreal tangentialPressure, qreal rotation, int z, Qt::KeyboardModifiers keyState, qint64 uniqueID )

Construit un événement de tablette du type type.

Le paramètre pos indique l'endroit où l'événement a eu lieu dans le widget ; globalPos est la position correspondante en coordonnées absolues. Le paramètre hiResGlobalPos contient une mesure en haute résolution de la position.

pressure contient la pression exercée sur le périphérique device.

pointerType décrit le type de stylet utilisé.

xTilt et yTilt contiennent le degré d'inclinaison du périphérique sur les axes X et Y, respectivement.

keyState spécifie les modificateurs de clavier qui sont enclenchés (par exemple, Ctrl).

Le paramètre uniqueID contient l'ID unique pour le périphérique courant.

Le paramètre z contient la coordonnée du périphérique sur la tablette. Ce paramètre est généralement produit par une roulette ou une souris 4D. Si le périphérique ne supporte pas l'axe Z, alors passez 0.

Le paramètre tangentialPressure contient la pression tangentielle d'un aérographe. Si le périphérique ne supporte pas la pression tangentielle, passez 0.

rotation contient la rotation du périphérique. Les souris 4D supportent la rotation. Si le périphérique ne la supporte pas, passez 0.

Voir aussi pos(), globalPos(), device(), pressure(), xTilt(), yTilt(), uniqueId(), rotation(), tangentialPressure() et z().

TabletDevice QTabletEvent::device () const

Retourne le type de périphérique qui a généré l'événement.

Voir aussi TabletDevice.

const QPoint & QTabletEvent::globalPos () const

Retourne la position globale du périphérique au moment de l'événement. Cela est important sur les gestionnaires de fenêtres asynchrones comme X11 ; à chaque fois que vous déplacez vos widgets en réponse aux événements de souris, globalPos() peut grandement différer de la position courante QCursor::pos().

Voir aussi globalX(), globalY() et hiResGlobalPos().

int QTabletEvent::globalX () const

Retourne la position globale, sur l'axe des X, du pointeur de la souris au moment de l'événement.

Voir aussi globalY(), globalPos() et hiResGlobalX().

int QTabletEvent::globalY () const

Retourne la position globale, sur l'axe des Y, du pointeur de la souris au moment de l'événement.

Voir aussi globalX(), globalPos() et hiResGlobalY().

const QPointF & QTabletEvent::hiResGlobalPos () const

Les coordonnées en haute résolution que la tablette a données. Les informations sur le sous-pixelage se trouvent dans la partie fractionnelle de QPointF.

Voir aussi globalPos(), hiResGlobalX() et hiResGlobalY().

qreal QTabletEvent::hiResGlobalX () const

La position en haute résolution, sur l'axe des X, du périphérique de la tablette.

qreal QTabletEvent::hiResGlobalY () const

La position en haute résolution, sur l'axe des Y, du périphérique de la tablette.

PointerType QTabletEvent::pointerType () const

Retourne le type de pointe qui a généré l'événement.

const QPoint & QTabletEvent::pos () const

Retourne la position du périphérique relative au widget receveur.

Si vous déplacez les widgets en réponse aux événements de souris, utilisez globalPos() à la place de cette fonction.

Voir aussi x(), y() et globalPos().

qreal QTabletEvent::pressure () const

Retourne la pression pour le périphérique. 0.0 indique que le stylet n'est pas sur la tablette, 1.0 indique la pression maximale pour le stylet.

Voir aussi tangentialPressure().

qreal QTabletEvent::rotation () const

Retourne la rotation du périphérique actuel en degrés. Cela est généralement donné par une souris 4D. Si le périphérique ne supporte pas la rotation, la valeur est toujours 0.0.

qreal QTabletEvent::tangentialPressure () const

Retourne la pression tangentielle du périphérique. Cela est généralement donné par une roulette ou un aérographe. L'échelle est de -1.0 à 1.0. La valeur 0.0 indique une position neutre. Actuellement, les aérographes ne peuvent que se déplacer dans la direction positive en partant du neutre. Si le périphérique ne supporte pas la pression tangentielle, la valeur est toujours 0.0.

Voir aussi pressure().

qint64 QTabletEvent::uniqueId () const

Retourne un ID unique pour le périphérique courant, rendant possible la différentiation entre plusieurs périphériques utilisant la même tablette.

Le support de cette fonctionnalité dépend de la tablette.

Les valeurs pour un même périphérique peuvent varier selon le système d'exploitation.

Les prochaines versions du pilote Wacom pour Linux vont indiquer cette information. Si vous avez une tablette qui supporte l'ID unique et que vous n'avez pas l'information sous Linux, veuillez mettre à jour votre pilote.

Depuis Qt 4.2, l'ID unique est le même pour toute orientation du stylet. Les anciennes versions auraient renvoyé une valeur différente selon que vous utilisiez le côté effaceur ou la pointe du stylet sous certains systèmes d'exploitation.

Voir aussi pointerType().

int QTabletEvent::x () const

Retourne la position du périphérique relative au widget receveur, sur l'axe des X.

Voir aussi y() and pos().

int QTabletEvent::xTilt () const

Retourne l'angle entre le périphérique (un stylet par exemple) et la perpendiculaire dans la direction de l'axe X. Les valeurs positives sont physiquement devant la tablette droite. L'angle est dans une échelle comprise entre -60 et +60 degrés.

Voir aussi yTilt().

int QTabletEvent::y () const

Retourne la position du périphérique relative au widget receveur, sur l'axe des Y.

Voir aussi x() and pos().

int QTabletEvent::yTilt () const

Retourne l'angle entre le périphérique (un stylet par exemple) et la perpendiculaire dans la direction de l'axe. Les valeurs positives sont physiquement devant la partie inférieure de la tablette. L'angle est dans une échelle comprise entre -60 et +60 degrés.

Voir aussi xTilt().

int QTabletEvent::z () const

Retourne la position du périphérique sur l'axe Z. Généralement cela est produit par une roulette ou une souris 4D. Si le périphérique ne supporte pas l'axe Z, alors la valeur est toujours 0. Cela n'est pas la même chose que la pression.

Voir aussi pressure().

Remerciements

Merci à Alexandre Laurent pour la traduction ainsi qu'à Jonathan Courtois et Claude Leloup pour leur relecture !