QWheelEvent

La classe QWheelEvent contient des param�tres qui d�crivent un �v�nement de d�filement. Plus d'informations...

#include <QWheelEvent>

Voir la position dans l'arbre des classes.

H�ritage

H�rite de QInputEvent.

Description d�taill�e

La classe QWheelEvent contient des param�tres qui d�crivent un �v�nement de d�filement.

Les �v�nements de d�filement sont envoy�s au widget sous le curseur de la souris. Si ce widget ne g�re pas l'�v�nement, il est envoy� au widget ayant le focus. La distance de rotation est fournie par delta(). Les fonctions pos() et globalPos() retournent les positions du curseur de la souris au moment de l'�v�nement.

Un �v�nement de d�filement contient un drapeau (flag) sp�cial de validation qui indique si le receveur veut ou non de l'�v�nement. Il est n�cessaire d'appeler ignore() si l'on ne g�re pas l'�v�nement de d�filement ; cela assure qu'il sera envoy� au widget parent.

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

Le gestionnaire d'�v�nements QWidget::wheelEvent() re�oit les �v�nements de d�filement.

Voir aussi QMouseEvent et QWidget::grabMouse().

Fonctions membres

QWheelEvent::QWheelEvent ( const QPoint & pos, int delta, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, Qt::Orientation orient = Qt::Vertical )

Construit un objet d'�v�nement de d�filement.

La position, pos, est la position du curseur de la souris � l'int�rieur du widget. La globalPos() est initialis�e � QCursor::pos() qui est d'habitude, mais pas toujours, correcte. Utilisez l'autre constructeur si vous souhaitez sp�cifier explicitement la position.

Le param�tre buttons d�crit l'�tat des boutons de la souris au moment de l'�v�nement, delta contient la distance de rotation, modifiers garde les drapeaux de modificateurs du clavier au moment de l'�v�nement et orient, l'orientation de la molette de la souris.

Voir aussi pos(), delta() et state().

QWheelEvent::QWheelEvent ( const QPoint & pos, const QPoint & globalPos, int delta, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, Qt::Orientation orient = Qt::Vertical )

Construit un objet d'�v�nement de d�filement.

La position pos fournit la position du curseur de la souris � l'int�rieur du widget. La position en coordonn�es globales est sp�cifi�e par globalPos. delta contient la distance de rotation, modifiers garde les drapeaux de modificateurs du clavier au moment de l'�v�nement et orient, l'orientation de la molette de la souris.

Voir aussi pos(), globalPos(), delta() et state().

Qt::MouseButtons QWheelEvent::buttons () const

Retourne l'�tat de la souris lorsque l'�v�nement s'est produit.

int QWheelEvent::delta () const

Retourne la distance de rotation de la molette, en huiti�mes de degr�s. Une valeur positive indique que la molette a tourn� vers l'avant par rapport � l'utilisateur ; une valeur n�gative indique qu'elle a tourn�e vers l'arri�re par rapport � l'utilisateur.

La plupart des types de souris fonctionnent par �tapes de 15 degr�s, auquel cas la valeur delta est un multiple de 120 ; c'est-�-dire que 120 unit�s * 1/8 = 15 degr�s.

Cependant, quelques souris ont des molettes de plus fine r�solution et envoient des valeurs delta qui sont inf�rieurs � 120 unit�s (moins de 15 degr�s). Pour supporter cette possibilit�, vous pouvez soit cumuler les valeurs delta des �v�nements jusqu'� ce que 120 soit atteint, puis faire d�filer le widget, soit partiellement d�filer le widget en r�ponse � chaque �v�nement de d�filement.

Exemple :

 void MyWidget::wheelEvent(QWheelEvent *event)
 {
     int numDegrees = event->delta() / 8;
     int numSteps = numDegrees / 15;
 
     if (event->orientation() == Qt::Horizontal) {
         scrollHorizontally(numSteps);
     } else {
         scrollVertically(numSteps);
     }
     event->accept();
 }

const QPoint & QWheelEvent::globalPos () const

Retourne la position globale du pointeur de la souris au moment de l'�v�nement. C'est important sur des syst�mes de fen�trage asynchrones tels que X11 ; � chaque fois que vous d�placez vos widgets en r�ponse � un �v�nement de souris, globalPos() peut grandement diff�rer de la position actuelle retourn�e par QCursor::pos().

Voir aussi globalX() et globalY().

int QWheelEvent::globalX () const

Retourne la position globale x du curseur de la souris au moment de l'�v�nement.

Voir aussi globalY() et globalPos().

int QWheelEvent::globalY () const

Retourne la position globale y du curseur de la souris au moment de l'�v�nement.

Voir aussi globalX() and globalPos().

Qt::Orientation QWheelEvent::orientation () const

Retourne l'orientation de la molette.

const QPoint & QWheelEvent::pos () const

Retourne la position du curseur de la souris relative au widget qui a re�u l'�v�nement.

Si vous d�placez vos widgets en r�ponse � des �v�nements de souris, utilisez globalPos() � la place de cette fonction.

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

int QWheelEvent::x () const

Retourne la position x du curseur de la souris relative au widget qui a re�u l'�v�nement.

Voir aussi y() et pos().

int QWheelEvent::y () const

Retourne la position y du curseur de la souris relative au widget qui a re�u l'�v�nement.

Voir aussi x() et pos().

Remerciements

Merci � Louis du Verdier pour la traduction et � Jonathan Courtois ainsi qu'� Maxime Gault pour leur relecture !