QContextMenuEvent

La classe QContextMenuEvent contient des param�tres d�crivant les �v�nements de menu contextuel. Plus d'informations...

 #include <QContextMenuEvent>

H�ritage

H�rite de QInputEvent.

Description d�taill�e

La classe QContextMenuEvent contient des param�tres d�crivant les �v�nements de menu contextuel.

Les �v�nements de menu contextuel sont envoy�s aux widgets lorsqu'un utilisateur effectue une action associ�e avec l'ouverture d'un menu contextuel. Les actions requises pour l'ouverture d'un menu contextuel d�pendent de la plateforme ; par exemple, sur Windows, l'appui sur le bouton menu ou un clic sur le bouton droit de la souris causera l'envoi de cet �v�nement.

Lorsque cet �v�nement se produit, il est d'usage d'afficher un QMenu avec un menu contextuel, si cet affichage est pertinent dans le contexte.

Les �v�nements de menu contextuel contiennent un drapeau sp�cial d'acceptation qui indique si le destinataire a accept� l'�v�nement. Si le gestionnaire de l'�v�nement n'accepte pas l'�v�nement, alors ce qui a d�clench� l'�v�nement sera, si possible, trait� comme un �v�nement d'entr�e normal.

Type

enum QContextMenuEvent::Reason

Cette �num�ration d�crit les raisons pour lesquelles cet �v�nement a �t� envoy�.

Fonctions membres

QContextMenuEvent::QContextMenuEvent ( Reason reason, const QPoint & pos, const QPoint & globalPos, Qt::KeyboardModifiers modifiers )

Construit un objet d'�v�nement de menu contextuel avec le drapeau d'acceptation d�sactiv�.

Le param�tre reason doit �tre QContextMenuEvent::Mouse ou QContextMenuEvent::Keyboard.

Le param�tre pos sp�cifie la position de la souris relativement au widget destinataire. globalPos est la position de la souris en coordonn�es absolues. modifiers contient les modificateurs clavier.

QContextMenuEvent::QContextMenuEvent ( Reason reason, const QPoint & pos, const QPoint & globalPos )

Construit un objet d'�v�nement de menu contextuel avec le drapeau d'acceptation d�sactiv�.

Le param�tre reason doit �tre QContextMenuEvent::Mouse ou QContextMenuEvent::Keyboard.

Le param�tre pos sp�cifie la position de la souris relativement au widget destinataire. globalPos est la position de la souris en coordonn�es absolues.

QContextMenuEvent::QContextMenuEvent ( Reason reason, const QPoint & pos )

Construit un objet d'�v�nement de menu contextuel avec le drapeau d'acceptation d�sactiv�.

Le param�tre reason doit �tre QContextMenuEvent::Mouse ou QContextMenuEvent::Keyboard.

Le param�tre pos sp�cifie la position de la souris relativement au widget destinataire.

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

const QPoint & QContextMenuEvent::globalPos () const

Renvoie la position globale du pointeur de souris au moment de l'�v�nement.

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

int QContextMenuEvent::globalX () const

Renvoie la position x du pointeur de souris au moment de l'�v�nement.

Voir aussi globalY() et globalPos().

int QContextMenuEvent::globalY () const

Renvoie la position y du pointeur de souris au moment de l'�v�nement.

Voir aussi globalX() et globalPos().

const QPoint & QContextMenuEvent::pos () const

Renvoie la position du pointeur de souris relativement au widget qui a re�u l'�v�nement.

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

Reason QContextMenuEvent::reason () const

Renvoie la cause de cet �v�nement.

int QContextMenuEvent::x () const

Renvoie la position x du pointeur de souris relativement au widget qui a re�u l'�v�nement.

Voir aussi y() et pos().

int QContextMenuEvent::y () const

Renvoie la position y du pointeur de souris relativement au widget qui a re�u l'�v�nement.

Voir aussi x() et pos().

Remerciements

Merci � Ilya Diallo pour la traduction ainsi qu'� Thibaut Cuvelier et Maxime Gault pour leur relecture !