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 !