QContextMenuEvent Class

Description détaillée

Un événement de menu contextuel est envoyé lorsqu'un utilisateur effectue une action qui devrait ouvrir un menu contextuel :

• en cliquant sur le bouton droit de la souris
• en appuyant sur une touche de menu dédiée du clavier (si le clavier en possède une, comme la touche de menu sur les claviers PC standard à 104 touches)
• en appuyant sur un autre raccourci clavier (tel que "Ctrl+Return" par défaut sur macOS 15 et les versions plus récentes).

Le menu contextuel attendu doit contenir actions qui sont pertinents pour un certain contenu de l'application (le "contexte"). Dans Qtt, le contexte est au moins le widget ou Qt Quick Item particulier qui reçoit le QContextMenuEvent. S'il y a une sélection, elle devrait probablement être considérée comme le contexte. Le contexte peut être affiné en utilisant QContextMenuEvent::pos() pour préciser le contenu du widget, de l'élément ou de la sélection.

Les widgets peuvent surcharger QWidget::contextMenuEvent() pour gérer cet événement. De nombreux widgets le font déjà et disposent par défaut de menus contextuels utiles. Certains widgets disposent d'une fonction telle que createStandardContextMenu() pour remplir l'ensemble des actions par défaut dans un QMenu, qui peut être personnalisé dans votre sous-classe, puis affiché.

Dans Qt Quick, l'événement peut être géré via la propriété ContextMenu attached. Certains contrôles QtQuick.Controls proposent déjà des menus contextuels par défaut.

Contrairement à la plupart des événements synthétiques (tels qu'un QMouseEvent envoyé uniquement après qu'un QTouchEvent ou QTabletEvent n'a pas été accepté), QContextMenuEvent est envoyé indépendamment du fait que l'événement souris ou touche d'origine a déjà été traité et accepted. Cela permet de s'adapter au modèle d'interface utilisateur de Windows, qui consiste à sélectionner certains types d'éléments (icônes, éléments de dessin ou cellules dans une vue d'élément) à l'aide du bouton droit de la souris (en cliquant ou en glissant), puis à obtenir un menu contextuel dès que l'on relâche le bouton droit de la souris. (Les actions du menu sont censées s'appliquer à la sélection.) Par conséquent, sous Windows, l'événement QContextMenuEvent est envoyé au relâchement de la souris, tandis que sur d'autres plateformes, il est envoyé à l'appui. Qt XML suit le platform convention par défaut.

Il existe également des contrôles Qt Quick, tels que Pane, qui acceptent les événements de la souris et reçoivent néanmoins un QContextMenuEvent après une pression ou un clic de la souris.

Si vous préférez prendre en charge le modèle d'interface utilisateur "appuyer-glisser-relâcher" pour ouvrir un menu contextuel lors de l'appui, et glisser sur un élément de menu pour le sélectionner lors du relâchement, vous devrez le faire en gérant directement QMouseEvents (en remplaçant virtual functions dans les sous-classes QWidget, ou en utilisant TapHandler pour ouvrir un Menu dans Qt Quick) ; et alors le QContextMenuEvent sera redondant lorsque le reason() est Mouse. Dans ce cas, vous devez ignore() l'événement ; mais vous devez toujours vous assurer que le widget, le contrôle personnalisé ou l'application peut répondre à un QContextMenuEvent qui comes from le raccourci clavier spécifique à la plate-forme.

Lorsqu'un QContextMenuEvent est ignored, Qtt tente de le délivrer à d'autres widgets et/ou Items sous le position (qui est généralement traduit à partir de la position du curseur).