QWidgetAction Class

Description détaillée

La plupart des actions d’une application sont représentées par des éléments de menu ou des boutons dans les barres d’outils. Cependant, des widgets plus complexes sont parfois nécessaires. Par exemple, une action de zoom dans un traitement de texte peut être réalisée à l’aide d’un ` QComboBox ` dans un ` QToolBar`, présentant une gamme de différents niveaux de zoom. ` QToolBar ` fournit la fonction pratique ` QToolBar::insertWidget()` pour insérer un seul widget. Cependant, si vous souhaitez implémenter une action qui utilise des widgets personnalisés pour l’affichage dans plusieurs conteneurs, vous devez alors créer une sous-classe de `QWidgetAction`.

Si une QWidgetAction est ajoutée, par exemple, à un QToolBar, alors la fonction QWidgetAction::createWidget() est appelée. Les réimplémentations de cette fonction doivent créer un nouveau widget personnalisé avec le parent spécifié.

Si l'action est supprimée d'un widget conteneur, la méthode ` QWidgetAction::deleteWidget()` est appelée avec le widget personnalisé créé précédemment comme argument. L'implémentation par défaut masque le widget et le supprime à l'aide de ` QObject::deleteLater()`.

Si vous ne disposez que d’un seul widget personnalisé, vous pouvez le définir comme widget par défaut à l’aide de ` setDefaultWidget()`. Ce widget sera alors utilisé si l’action est ajoutée à un ` QToolBar`, ou plus généralement à un conteneur d’actions prenant en charge `QWidgetAction`. Si un QWidgetAction ne comportant qu’un seul widget par défaut est ajouté simultanément à deux barres d’outils, le widget par défaut n’apparaîtra que dans la première barre d’outils à laquelle l’action a été ajoutée. QWidgetAction prend alors possession du widget par défaut.

Notez qu’il appartient au widget d’activer l’action, par exemple en réimplémentant des gestionnaires d’événements de souris et en appelant ` QAction::trigger()`().

macOS: si vous ajoutez un widget à un menu de la barre de menus de l’application sous macOS, le widget sera ajouté et fonctionnera, mais avec certaines limitations :

1. Le widget est détaché de l’ QMenu pour être rattaché à la vue de menu native. Si vous affichez le menu à un autre endroit (par exemple sous forme de menu contextuel), le widget n’y figurera pas.
2. La gestion du focus et du clavier pour le widget n'est pas possible.
3. En raison de la conception d’Apple, le suivi de la souris sur le widget ne fonctionne pas actuellement.
4. Le fait de connecter le signal « triggered » () à un slot ouvrant une boîte de dialogue modale provoquera un plantage sous macOS 10.4 (bug connu et reconnu par Apple) ; une solution consiste à utiliser une « QueuedConnection » à la place d’une « DirectConnection ».