Notice: Undefined offset: 1 in /home/developpez/www/developpez-com/upload/qt/doc/redir.php on line 39 QTabletEvent
Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Toutes les fonctions  ·  Vues d'ensemble  · 

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.

Constante Valeur Description
QTabletEvent::UnknownPointer   Un périphérique inconnu.
QTabletEvent::Pen 1 Pointe d'un stylet (la partie pointue du stylet).
QTabletEvent::Cursor 2 N'importe quel périphérique en caoutchouc.
QTabletEvent::Eraser 3 Côté effaceur d'un stylet (le côté large du stylet).

Voir aussi pointerType().

enum QTabletEvent::TabletDevice

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

Constante Valeur Description
QTabletEvent::NoDevice   Aucun périphérique ou inconnu.
QTabletEvent::Puck 1 Un caoutchouc (un périphérique qui ressemble à une souris plate avec un cercle transparent et une fine croix).
QTabletEvent::Stylus 2 Un stylet.
QTabletEvent::Airbrush 3 Un aérographe
QTabletEvent::FourDMouse 4 Une souris 4D.
QTabletEvent::RotationStylus 6 Un stylet spécial qui capte les rotations (un stylet 6D).

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.

image

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 !

Publicité

Best Of

Actualités les plus lues

Semaine
Mois
Année
  1. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 94
  2. Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
  3. Pourquoi les programmeurs sont-ils moins payés que les gestionnaires de programmes ? Manquent-ils de pouvoir de négociation ? 43
  4. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  5. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
  6. Qt Commercial : Digia organise un webinar gratuit le 27 mars sur la conception d'interfaces utilisateur et d'applications avec le framework 0
  7. 2017 : un quinquennat pour une nouvelle version du C++ ? Possible, selon Herb Sutter 9
Page suivante

Le blog Digia au hasard

Logo

Déploiement d'applications Qt Commercial sur les tablettes Windows 8

Le blog Digia est l'endroit privilégié pour la communication sur l'édition commerciale de Qt, où des réponses publiques sont apportées aux questions les plus posées au support. Lire l'article.

Communauté

Ressources

Liens utiles

Contact

  • Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 4.7
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
 
 
 
 
Partenaires

Hébergement Web