Sur cette page

Qt Widgets DesignerMode d'édition des widgets

Capture d'écran montrant le mode d'édition de Qt Widgets Designer, permettant de modifier la taille ou la position d'un composant dans une disposition.

Dans le mode d'édition des widgets, les objets peuvent être déplacés de la boîte à widgets de la fenêtre principale vers un formulaire, modifiés, redimensionnés, déplacés sur le formulaire et même déplacés d'un formulaire à l'autre. Les propriétés des objets peuvent être modifiées de manière interactive, de sorte que les changements sont immédiatement visibles. L'interface d'édition est intuitive pour les opérations simples, tout en prenant en charge les puissantes fonctions de mise en page de Qt.

Pour créer et éditer de nouveaux formulaires, ouvrez le menu Fichier et sélectionnez Nouveau formulaire... ou appuyez sur Ctrl+N. Les formulaires existants peuvent également être édités en sélectionnant Ouvrir un formulaire... dans le menu Fichier ou en appuyant sur Ctrl+O.

À tout moment, vous pouvez enregistrer votre formulaire en sélectionnant l'option Enregistrer sous... dans le menu Fichier. Les fichiers UI enregistrés par Qt Widgets Designer contiennent des informations sur les objets utilisés, ainsi que des détails sur les connexions de signaux et de fentes entre eux.

Édition d'un formulaire

Par défaut, les nouveaux formulaires sont ouverts en mode d'édition de widgets. Pour passer au mode d'édition à partir d'un autre mode, sélectionnez Éditer les widgets dans le menu Édition ou appuyez sur la touche F3.

Les objets sont ajoutés au formulaire en les faisant glisser depuis la boîte à widgets principale et en les déposant à l'endroit souhaité sur le formulaire. Une fois sur place, ils peuvent être déplacés simplement en les faisant glisser ou en utilisant les touches du curseur. En appuyant simultanément sur la touche Ctrl, le widget sélectionné est déplacé pixel par pixel, tandis qu'en utilisant uniquement les touches du curseur, le widget sélectionné s'accroche à la grille lorsqu'il est déplacé. Les objets peuvent être sélectionnés en cliquant dessus avec le bouton gauche de la souris. Vous pouvez également utiliser la touche Tab pour modifier la sélection.

La boîte à outils contient des objets de différentes catégories, qui peuvent tous être placés sur le formulaire en fonction des besoins. Les seuls objets qui nécessitent un peu plus de préparation sont les widgets Conteneur. Ceux-ci sont décrits plus en détail dans le chapitre Utilisation des conteneurs dans Qt Widgets Designer.

Capture d'écran montrant un widget sélectionné en mode éditeur de Qt Widgets DesignerSélection des objets

Les objets du formulaire sont sélectionnés en cliquant dessus avec le bouton gauche de la souris. Lorsqu'un objet est sélectionné, des poignées de redimensionnement sont affichées à chaque coin et au milieu de chaque côté, indiquant qu'il peut être redimensionné.

Pour sélectionner d'autres objets, maintenez la touche Contrôle enfoncée et cliquez dessus. Si plusieurs objets sont sélectionnés, l'objet actuel est affiché avec des poignées de redimensionnement d'une couleur différente.

Pour déplacer un widget dans une disposition, maintenez les touches Maj et Contrôle enfoncées tout en faisant glisser le widget. Cela permet d'étendre la sélection à la disposition parente du widget.

Il est également possible de sélectionner des objets dans l'inspecteur d'objets.

Lorsqu'un widget est sélectionné, les opérations normales du presse-papiers, telles que couper, copier et coller, peuvent être effectuées. Toutes ces opérations peuvent être effectuées et annulées, si nécessaire.

Les raccourcis suivants peuvent être utilisés :

ActionRaccourciDescription de l'action
CouperCtrl+XCoupe les objets sélectionnés dans le presse-papiers.
CopierCtrl+CCopie les objets sélectionnés dans le presse-papiers.
CollerCtrl+VColle les objets du presse-papiers dans le formulaire.
SupprimerSupprimerSupprime les objets sélectionnés.
Cloner un objetCtrl+drag (bouton gauche de la souris)Fait une copie de l'objet ou du groupe d'objets sélectionnés.
AperçuCtrl+RAffiche un aperçu du formulaire.

Toutes les actions ci-dessus (à l'exception du clonage) sont accessibles via le menu Edition et le menu contextuel du formulaire. Ces menus proposent également des fonctions de disposition des objets ainsi qu'une fonction Sélectionner tout qui permet de sélectionner tous les objets du formulaire.

Les widgets ne sont pas des objets uniques ; vous pouvez en faire autant de copies que nécessaire. Pour dupliquer rapidement un widget, vous pouvez le cloner en maintenant la touche Ctrl enfoncée et en le faisant glisser. Cela permet de copier et de placer les widgets sur le formulaire plus rapidement qu'avec les opérations du presse-papiers.

Capture d'écran montrant des widgets dans l'éditeur d'interface utilisateur qui peuvent être déplacés librement en utilisant la fonction "glisser-déposer".Glisser-déposer

Qt Widgets Designer fait un usage intensif des fonctions de glisser-déposer fournies par Qt. Les widgets peuvent être tirés de la boîte à widgets et déposés sur le formulaire.

Les widgets peuvent également être "clonés" sur le formulaire : En maintenant la touche Ctrl enfoncée et en faisant glisser le widget, on crée une copie du widget qui peut être déplacée vers une nouvelle position.

Il est également possible de déposer des widgets dans l'inspecteur d'objets afin de gérer facilement les mises en page imbriquées.

Qt Widgets Designer permet de copier, coller et faire glisser des sélections d'objets entre les formulaires. Vous pouvez utiliser cette fonction pour créer plusieurs copies d'un même formulaire et expérimenter différentes mises en page dans chacune d'entre elles.

L'éditeur de propriétés

L'éditeur de propriétés affiche toujours les propriétés de l'objet sélectionné dans le formulaire. Les propriétés disponibles dépendent de l'objet en cours d'édition, mais tous les widgets fournis ont des propriétés communes telles que objectName, le nom interne de l'objet, et enabled, la propriété qui détermine si l'on peut interagir avec un objet ou non.

Capture d'écran montrant l'éditeur de propriétés d'un widget avec des options permettant de modifier librement le widget.Édition des propriétés

L'éditeur de propriétés utilise les widgets d'entrée Qt Widgets standard pour gérer les propriétés des objets du formulaire. Les propriétés textuelles sont affichées dans les éditions de lignes, les propriétés entières sont affichées dans des boîtes de dialogue, les propriétés booléennes sont affichées dans des cases à cocher et les propriétés composées telles que les couleurs et les tailles sont présentées dans des listes déroulantes de widgets d'entrée.

Les propriétés modifiées sont indiquées par des étiquettes en gras. Pour les réinitialiser, cliquez sur le bouton fléché à droite.

Les modifications apportées aux propriétés sont appliquées à tous les objets sélectionnés qui possèdent la même propriété.

Certaines propriétés font l'objet d'un traitement particulier par l'éditeur de propriétés :

  • Les propriétés composées - les propriétés composées de plus d'une valeur - sont représentées sous forme de nœuds qui peuvent être développés, ce qui permet de modifier leurs valeurs.
  • Les propriétés qui contiennent un choix ou une sélection de drapeaux sont éditées via des boîtes combo avec des éléments à cocher.
  • Les propriétés qui permettent d'accéder à des types de données riches, comme QPalette, sont modifiées à l'aide de boîtes de dialogue qui s'ouvrent lorsque les propriétés sont modifiées. QLabel et les widgets de la section Boutons de la boîte à widgets ont une propriété text qui peut également être modifiée en double-cliquant sur le widget ou en appuyant sur F2. Qt Widgets Designer interprète le caractère barre oblique inverse (\) de manière spéciale, ce qui permet d'insérer des caractères de nouvelle ligne (\n) dans le texte ; la séquence de caractères \\ est utilisée pour insérer une seule barre oblique inverse dans le texte. Un menu contextuel peut également être ouvert pendant l'édition, offrant une autre façon d'insérer des caractères spéciaux et des nouvelles lignes dans le texte.

Propriétés dynamiques

L'éditeur de propriétés peut également être utilisé pour ajouter de nouvelles dynamic properties aux widgets Qt Widgets standard et aux formulaires eux-mêmes. Depuis Qt 4.4, les propriétés dynamiques sont ajoutées et supprimées via la barre d'outils de l'éditeur de propriétés, illustrée ci-dessous.

Capture d'écran montrant la barre d'outils de l'éditeur de propriétés pour un widget

Pour ajouter une propriété dynamique, cliquez sur le bouton Ajouter Ajouter un bouton. Pour la supprimer, cliquez plutôt sur le bouton Remove Supprimer le bouton. Vous pouvez également trier les propriétés par ordre alphabétique et modifier les groupes de couleurs en cliquant sur le bouton Configurer Bouton de configuration.

L'inspecteur d'objets

Capture d'écran montrant une arborescence de tous les widgets de la mise en pageL'inspecteur d'objets

L'inspecteur d'objets affiche une liste hiérarchique de tous les objets du formulaire en cours d'édition. Pour afficher les objets enfants d'un widget conteneur ou d'une disposition, cliquez sur la poignée située à côté de l'étiquette de l'objet.

Chaque objet d'un formulaire peut être sélectionné en cliquant sur l'élément correspondant dans l'inspecteur d'objets. Un clic droit permet d'ouvrir le menu contextuel du formulaire. Ces fonctions peuvent s'avérer utiles si de nombreux objets se chevauchent. Pour localiser un objet dans l'inspecteur d'objets, utilisez Ctrl+F.

Depuis Qt 4.4, un double-clic sur le nom de l'objet vous permet de modifier le nom de l'objet à l'aide de l'éditeur in-situ.

Depuis Qt 4.5, l'inspecteur d'objets affiche l'état de la disposition des conteneurs. L'icône de disposition cassée ###ICON est affichée si quelque chose ne va pas avec les dispositions.

© 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.