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 !