QMouseEvent

La classe QMouseEvent comporte des param�tres qui d�crivent un �v�nement de souris. Plus d'informations...

#include <QMouseEvent>

Voir la position dans l'arbre des classes.

H�ritage

H�rite de QInputEvent.

Description d�taill�e

La classe QMouseEvent comporte des param�tres qui d�crivent un �v�nement de souris.

Les �v�nements de souris surviennent lorsqu'un bouton de la souris est enfonc� ou rel�ch� � l'int�rieur d'un widget, ou simplement quand le curseur de la souris est d�plac�.

Les �v�nements de mouvement de souris surviennent uniquement lorsqu'un bouton de la souris est enfonc�, � moins que le suivit de la souris ait �t� activ� par le biais de QWidget::setMouseTracking().

Qt saisit automatiquement la souris quand un de ses boutons est press� � l'int�rieur d'un widget, qui va continuer de recevoir des �v�nements de souris jusqu'� ce que le dernier bouton enfonc� de la souris soit rel�ch�.

Un �v�nement de souris contient un drapeau sp�cial d'admission qui indique si le receveur veut de l'�v�nement. Vous devez appeler ignore() si l'�v�nement n'est pas g�r� par votre widget. Un �v�nement de souris est propag� dans la cha�ne des widgets parents jusqu'� ce que l'un d'entre eux l'accepte avec accept(), ou bien jusqu'� ce qu'un filtre d'�v�nements le prenne en charge.

Note : si un �v�nement de souris est propag� � un widget pour lequel Qt::WA_NoMousePropagation a �t� d�fini, cet �v�nement ne sera pas propag� dans la cha�ne des widgets parents.

L'�tat des modificateurs peut �tre obtenu par la fonction modifiers(), h�rit�e de QInputEvent.

Les fonctions pos(), x() et y() donnent une position de curseur relative au widget recevant l'�v�nement. Si vous d�placez le widget suite � un �v�nement de souris, utilisez plut�t la position globale retourn�e par globalPos() pour �viter un mouvement saccad�.

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

R�impl�mentez les gestionnaires d'�v�nements QWidget::mousePressEvent(), QWidget::mouseReleaseEvent(), QWidget::mouseDoubleClickEvent() et QWidget::mouseMoveEvent() de QWidget pour recevoir des �v�nements de souris dans vos propres widgets.

QCursor::pos()

Voir aussi QWidget::setMouseTracking() et QWidget::grabMouse().

Fonctions membres

QMouseEvent::QMouseEvent ( Type type, const QPoint & position, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers )

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

Le param�tre type doit �tre l'un des param�tres suivants : QEvent::MouseButtonPress, QEvent::MouseButtonRelease, QEvent::MouseButtonDblClick ou QEvent::MouseMove.

La position est la position du curseur de la souris, relative au widget r�cepteur. Le bouton button qui entraine l'�v�nement est donn� en tant que valeur depuis l'�num�ration Qt::MouseButton. Si le type de l'�v�nement est MouseMove, le bouton appropri� pour l'�v�nement est Qt::NoButton. Les �tats du clavier de la souris au moment de l'�v�nement sont sp�cifi�s par les param�tres buttons et modifiers.

La globalPos() est initialis�e � QCursor::pos(), qui peut ne pas �tre appropri�e. Utilisez l'autre constructeur pour sp�cifier explicitement la position globale.

QMouseEvent::QMouseEvent ( Type type, const QPoint & pos, const QPoint & globalPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers )

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

Le param�tre type doit �tre QEvent::MouseButtonPress, QEvent::MouseButtonRelease, QEvent::MouseButtonDblClick ou QEvent::MouseMove.

La position est la position du curseur de la souris, relative au widget r�cepteur. La position du curseur dans les coordonn�es globales est sp�cifi�e par globalPos. Le bouton button qui entraine l'�v�nement est donn� en tant que valeur depuis l'�num�ration Qt::MouseButton. Si le type de l'�v�nement est MouseMove, le bouton appropri� pour l'�v�nement est Qt::NoButton. Le param�tre buttons est l'�tat de tous les boutons au moment de l'�v�nement, et modifiers, l'�tat de tous les modificateurs.

Qt::MouseButton QMouseEvent::button () const

Retourne le bouton ayant caus� l'�v�nement.

Notez que la valeur retourn�e est toujours Qt::NoButton pour les �v�nements de mouvement de souris.

Voir aussi buttons() et Qt::MouseButton.

Qt::MouseButtons QMouseEvent::buttons () const

Retourne l'�tat des boutons au moment o� l'�v�nement a �t� g�n�r�. L'�tat des boutons est une combinaison de Qt::LeftButton, Qt::RightButton, Qt::MidButton avec l'op�rateur OU. Pour les �v�nements de mouvement de souris, c'est la totalit� des boutons qui sont enfonc�s. Pour les �v�nements d'enfoncement de souris et de double-clic, cela inclut le bouton ayant caus� l'�v�nement. Pour les �v�nements de rel�chement de souris, cela exclut le bouton ayant caus� l'�v�nement.

Voir aussi button() et Qt::MouseButton.

const QPoint & QMouseEvent::globalPos () const

Retourne la position globale du curseur au moment de l'�v�nement. C'est important sous des syst�mes de fen�trage asynchrones comme X11. Chaque fois que vous d�placez vos widgets en r�ponse � des �v�nements de souris, globalPos() peut diff�rer grandement de la position actuelle du curseur QCursor::pos(), et de QWidget::mapToGlobal(pos()).

Voir aussi globalX() et globalY().

int QMouseEvent::globalX () const

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

Voir aussi globalY() et globalPos().

int QMouseEvent::globalY () const

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

Voir aussi globalX() et globalPos().

const QPoint & QMouseEvent::pos () const

Retourne la position du curseur de la souris, relative au widget r�cepteur de l'�v�nement.

Si, en r�sultat � l'�v�nement de souris, vous d�placez le widget, utilisez plut�t la position globale retourn�e par globalPos() pour �viter un mouvement saccad�.

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

QPointF QMouseEvent::posF () const

Retourne la position du curseur de la souris en tant que QPointF, relative au widget r�cepteur de l'�v�nement.

Si, en r�sultat � l'�v�nement de souris, vous d�placez le widget, utilisez plut�t la position globale retourn�e par globalPos() pour �viter un mouvement saccad�.

Cette fonction a �t� introduite dans Qt 4.4.

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

int QMouseEvent::x () const

Retourne la position x du curseur de la souris, relative au widget r�cepteur de l'�v�nement.

Voir aussi y() et pos().

int QMouseEvent::y () const

Retourne la position y du curseur de la souris, relative au widget r�cepteur de l'�v�nement.

Voir aussi x() et pos().

Remerciements

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