Sur cette page

Création de fenêtres principales dans Qt Widgets Designer

Qt Widgets Designer peut être utilisé pour créer des interfaces utilisateur à des fins différentes, et il fournit différents types de modèles de formulaires pour chaque interface utilisateur. Le modèle de fenêtre principale est utilisé pour créer des fenêtres d'application avec des barres de menu, des barres d'outils et des widgets d'ancrage.

Créez une nouvelle fenêtre principale en ouvrant le menu Fichier et en sélectionnant l'option Nouveau formulaire ou en appuyant sur Ctrl+N. Sélectionnez ensuite le modèle Fenêtre principale. Ce modèle fournit une fenêtre d'application principale contenant une barre de menu et une barre d'outils par défaut - celles-ci peuvent être supprimées si elles ne sont pas nécessaires.

Si vous supprimez la barre de menu, vous pouvez en créer une nouvelle en sélectionnant l'option Créer une barre de menu dans le menu contextuel, que vous pouvez obtenir en cliquant avec le bouton droit de la souris dans le formulaire de la fenêtre principale.

Une application ne peut avoir qu'une seule barre de menu, mais plusieurs barres d'outils.

Les menus sont ajoutés à la barre de menus en modifiant les espaces réservés Type Here. L'un d'entre eux est toujours présent à des fins d'édition et ne sera pas affiché dans l'aperçu ou dans la fenêtre finie.

Une fois créé, les propriétés d'un menu sont accessibles à l'aide de l'éditeur de propriétés, et chaque menu est accessible à cette fin via l'inspecteur d'objets.

Les menus existants peuvent être supprimés en ouvrant un menu contextuel sur l'étiquette dans la barre de menus et en sélectionnant Supprimer le menu 'nom_du_menu'.

Capture d'écran montrant le curseur survolant un bouton pour créer un menu sur la fenêtre Capture d'écran montrant le curseur cliquant sur le bouton pour créer un menu sur la fenêtre
Capture d'écran montrant un champ de texte résultant d'un clic sur le bouton pour nommer le menu Capture d'écran montrant le menu nouvellement créé

Création d'un menu

Double-cliquez sur l'élément de l'espace réservé pour commencer à le modifier. Le texte du menu, affiché à l'aide d'une ligne d'édition, peut être modifié.

Insérez le texte requis pour le nouveau menu. L'insertion d'une esperluette (&) entraîne l'utilisation de la lettre qui la suit comme moyen mnémotechnique pour le menu.

Appuyez sur Retour ou Entrée pour accepter le nouveau texte, ou sur Echap pour le rejeter. Vous pouvez annuler l'opération de modification ultérieurement si nécessaire.

Les menus peuvent également être réorganisés dans la barre de menus en les faisant simplement glisser et en les déposant à l'endroit souhaité. Une ligne verticale rouge indique l'endroit où le menu sera inséré.

Les menus peuvent contenir un nombre illimité d'entrées et de séparateurs, et peuvent être imbriqués jusqu'à la profondeur voulue. Pour ajouter de nouvelles entrées aux menus, il suffit de naviguer dans la structure des menus de la manière habituelle.

Capture d'écran du curseur cliquant sur le nouveau menu affichant un menu déroulant avec un bouton permettant de créer des options ou des séparateurs dans le menu déroulant. Capture d'écran du curseur cliquant sur le bouton pour ajouter une option au menu déroulant en écrivant un nom dans le champ de texte.
Capture d'écran montrant le bouton nouvellement créé dans le menu déroulant Image du curseur cliquant sur le bouton montrant une option pour créer un autre bouton qui apparaît après avoir cliqué.

Création d'une entrée de menu

Double-cliquez sur l'espace réservé Type Here pour commencer l'édition, ou double-cliquez sur Add Separator pour insérer une nouvelle ligne de séparation après la dernière entrée du menu.

Le texte de l'entrée de menu est affiché à l'aide d'une ligne d'édition et peut être modifié.

Insérez le texte requis pour la nouvelle entrée, en utilisant éventuellement le caractère esperluette (&) pour marquer la lettre à utiliser comme moyen mnémotechnique pour l'entrée.

Appuyez sur Retour ou Entrée pour accepter le nouveau texte, ou sur Echap pour le rejeter. L'action créée pour cette entrée de menu sera accessible via l'éditeur d'action, et tout raccourci clavier associé peut être défini à cet endroit.

Comme pour les menus, les entrées peuvent être déplacées en les faisant simplement glisser et en les déposant à l'endroit souhaité. Lorsqu'une entrée est glissée sur un menu fermé, le menu s'ouvre pour permettre son insertion. Comme les entrées de menu sont basées sur des actions, elles peuvent également être déposées sur les barres d'outils, où elles s'afficheront sous forme de boutons de barre d'outils.

Barres d'outils

Capture d'écran montrant la possibilité d'ajouter une barre d'outils en cliquant avec le bouton droit de la souris sur l'éditeur d'interface utilisateur.

Création et suppression d'une barre d'outils

Les barres d'outils sont ajoutées à la fenêtre principale de la même manière que la barre de menu : Sélectionnez l'option Ajouter une barre d'outils dans le menu contextuel du formulaire. S'il existe déjà une barre d'outils dans la fenêtre principale, vous pouvez également cliquer sur la flèche située à son extrémité droite pour créer une nouvelle barre d'outils.

Les barres d'outils sont supprimées du formulaire par une entrée dans le menu contextuel de la barre d'outils.

Ajout et suppression de boutons de barre d'outils

Les boutons de la barre d'outils sont créés en tant qu'actions dans l'éditeur d'actions et glissés sur la barre d'outils. Comme les actions peuvent être représentées par des entrées de menu et des boutons de barre d'outils, elles peuvent être déplacées entre les menus et les barres d'outils.

Capture d'écran montrant le curseur ajoutant une barre d'outils par glisser-déposer Capture d'écran montrant la possibilité de supprimer la barre d'outils en cliquant dessus avec le bouton droit de la souris.

Pour partager une action entre un menu et une barre d'outils, faites glisser son icône depuis l'éditeur d'actions vers la barre d'outils plutôt que depuis le menu où se trouve son entrée. Voir Ajouter une action pour plus d'informations sur ce processus.

Les boutons de la barre d'outils sont supprimés via le menu contextuel de la barre d'outils.

Actions

La barre de menu et les barres d'outils étant en place, il est temps de les remplir d'actions. Les nouvelles actions pour les menus et les barres d'outils sont créées dans la fenêtre de l'éditeur d'actions, ce qui simplifie la création et la gestion des actions.

Capture d'écran de l'éditeur d'actions listant toutes les actions d'une barre d'outils

L'éditeur d'actions

Activez l'éditeur d'actions en ouvrant le menu Outils et en activant l'option Éditeur d'actions.

L'éditeur d'actions vous permet de créer de nouvelles actions et de supprimer des actions. Il offre également une fonction de recherche, Filtre, utilisant le texte de l'action.

Qt Widgets DesignerL'éditeur d'actions peut être visualisé dans la vue classique des icônes et dans la vue détaillée. La capture d'écran ci-dessous montre l'éditeur d'actions en vue détaillée. Vous pouvez également copier et coller des actions entre les menus, les barres d'outils et les formulaires.

Création d'une action

Pour créer une action, utilisez le bouton Nouveau de l'éditeur d'actions, qui fait apparaître une boîte de dialogue de saisie. Attribuez un texte à la nouvelle action - il s'agit du texte qui apparaîtra dans une entrée de menu et dans l'infobulle de l'action. Le texte est également ajouté automatiquement à un préfixe "action", créant ainsi le nom d'objet de l'action.

En outre, la boîte de dialogue offre la possibilité de sélectionner une icône pour l'action, ainsi que de supprimer l'icône actuelle.

Une fois l'action créée, elle peut être utilisée partout où des actions sont applicables.

Capture d'écran montrant le curseur ajoutant une barre d'outils par glisser-déposer Capture d'écran montrant la possibilité de supprimer la barre d'outils en cliquant dessus avec le bouton droit de la souris.

Ajout d'une action

Pour ajouter une action à un menu ou à une barre d'outils, il suffit de cliquer avec le bouton gauche de la souris sur l'action dans l'éditeur d'actions et de la faire glisser à l'endroit souhaité.

Qt Widgets Designer Les lignes de guidage en surbrillance vous indiquent l'endroit où l'action sera ajoutée. Relâchez le bouton de la souris pour ajouter l'action lorsque vous avez trouvé le bon endroit.

Widgets du dock

Les widgets d'ancrage sont également des widgets de conteneur. Ils peuvent être ajoutés à un formulaire en les déposant dans la zone d'ancrage souhaitée.

Capture d'écran montrant comment ajouter un widget dock par glisser-déposer

Ajouter un widget dock

Pour ajouter un widget dock à un formulaire, faites-en glisser un depuis la section Conteneurs de la boîte à widgets et déposez-le dans la zone principale du formulaire. N'ajoutez pas le widget dock à une mise en page existante. Ouvrez plutôt l'éditeur de propriétés et activez la propriété docked pour la placer dans une zone dock.

Notez qu'il est parfois plus facile de configurer un widget d'ancrage s'il est ajouté à un formulaire avant qu'une mise en page ne soit appliquée au widget central. Par exemple, il est possible de le désancrer et de le redimensionner, ce qui facilite l'ajout de widgets enfants.

Les widgets d'ancrage peuvent être optionnellement flottés comme des fenêtres d'outils indépendantes. Il est donc utile de leur donner des titres de fenêtre en définissant leur propriété windowTitle. Cela permet également de les identifier sur le formulaire.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.