QTabletEventLa 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éritageHérite de QInputEvent. Description détailléeLa 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 X11Qt 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. Typeenum QTabletEvent::PointerTypeCette enum définit quel type de pointe génère l'événement.
Voir aussi pointerType(). enum QTabletEvent::TabletDeviceCet 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 membresQTabletEvent::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 () constRetourne le type de périphérique qui a généré l'événement. Voir aussi TabletDevice. const QPoint & QTabletEvent::globalPos () constRetourne 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 () constRetourne 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 () constRetourne 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 () constLes 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 () constLa position en haute résolution, sur l'axe des X, du périphérique de la tablette. qreal QTabletEvent::hiResGlobalY () constLa position en haute résolution, sur l'axe des Y, du périphérique de la tablette. PointerType QTabletEvent::pointerType () constRetourne le type de pointe qui a généré l'événement. const QPoint & QTabletEvent::pos () constRetourne 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 () constRetourne 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 () constRetourne 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 () constRetourne 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 () constRetourne 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 () constRetourne la position du périphérique relative au widget receveur, sur l'axe des X. int QTabletEvent::xTilt () constRetourne 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 () constRetourne la position du périphérique relative au widget receveur, sur l'axe des Y. int QTabletEvent::yTilt () constRetourne 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 () constRetourne 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(). RemerciementsMerci à Alexandre Laurent pour la traduction ainsi qu'à Jonathan Courtois et Claude Leloup pour leur relecture ! |
Publicité
Best OfActualités les plus luesSemaine
Mois
Année
Le blog Digia au hasardDéploiement d'applications Qt Commercial sur les tablettes Windows 8Le 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 utilesContact
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 ! |
Copyright © 2000-2012 - www.developpez.com