QWidgetAction Class

Description détaillée

La plupart des actions dans une application sont représentées par des éléments dans les menus 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 niveaux de zoom différents. QToolBar fournit QToolBar::insertWidget() comme fonction de commodité pour l'insertion d'un widget unique. Toutefois, si vous souhaitez mettre en œuvre une action qui utilise des widgets personnalisés pour la visualisation dans plusieurs conteneurs, vous devez sous-classer QWidgetAction.

Si un QWidgetAction est ajouté, par exemple, à un site QToolBar, 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 fonction QWidgetAction::deleteWidget() est appelée avec le widget personnalisé précédemment créé comme argument. L'implémentation par défaut cache le widget et le supprime à l'aide de QObject::deleteLater().

Si vous n'avez qu'un seul widget personnalisé, vous pouvez le définir comme widget par défaut en utilisant setDefaultWidget(). Ce widget sera alors utilisé si l'action est ajoutée à un QToolBar, ou en général à un conteneur d'action qui prend en charge QWidgetAction. Si une action QWidgetAction ne comportant qu'un widget par défaut est ajoutée à deux barres d'outils en même temps, le widget par défaut n'est affiché que dans la première barre d'outils à laquelle l'action a été ajoutée. QWidgetAction devient propriétaire du widget par défaut.

Notez que c'est au widget d'activer l'action, par exemple en réimplémentant les gestionnaires d'événements de la souris et en appelant QAction::trigger().

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

1. Le widget est reparti de la page QMenu vers la vue native du menu. Si vous affichez le menu à un autre endroit (par exemple en tant que menu contextuel), le widget ne sera pas présent.
2. La gestion du focus/clavier du 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. La connexion du signal triggered() à un slot qui ouvre une boîte de dialogue modale provoque un crash dans macOS 10.4 (bogue connu et reconnu par Apple), une solution de contournement consiste à utiliser une QueuedConnection au lieu d'une DirectConnection.