Sur cette page

Qt Widgets DesignerMode d'édition 's Signals and Slots

Capture d'écran du mode connexion de <span translate=Qt Widgets Designer montrant la connexion des signaux entre deux widgets." src="images/designer-connection-mode.png" title="Capture d'écran du mode connexion de Qt Widgets Designer montrant la connexion des signaux entre deux widgets."/>

Dans le mode d'édition des signaux et des slots de Qt Widgets Designer, vous pouvez connecter les objets d'un formulaire en utilisant le mécanisme des signaux et des slots de Qt. Les widgets et les layouts peuvent être connectés via une interface de connexion intuitive, en utilisant le menu de signaux et de slots compatibles fourni par Qt Widgets Designer. Lorsqu'un formulaire est sauvegardé, toutes les connexions sont préservées de sorte qu'elles seront prêtes à être utilisées lorsque votre projet sera construit.

Pour plus d'informations sur le mécanisme des signaux et des sltos de Qt, reportez-vous au document Signaux et slots.

Connecter des objets

Pour commencer à connecter des objets, entrez dans le mode d'édition des signaux et des slots en ouvrant le menu Edit et en sélectionnant Edit Signals/Slots, ou en appuyant sur la touche F4.

Tous les widgets et toutes les présentations du formulaire peuvent être reliés entre eux. Cependant, les espaceurs ne font que donner des indications d'espacement aux modèles, ils ne peuvent donc pas être connectés à d'autres objets.

Capture d'écran montrant un widget d'une mise en page en surbrillanceObjets en surbrillance

Lorsque le curseur se trouve au-dessus d'un objet pouvant être utilisé dans une connexion, l'objet est mis en surbrillance.

Pour établir une connexion, appuyez sur le bouton gauche de la souris et faites glisser le curseur vers l'objet auquel vous souhaitez le connecter. Ce faisant, une ligne s'étend de l'objet source au curseur. Si le curseur se trouve au-dessus d'un autre objet du formulaire, la ligne se termine par une flèche qui pointe vers l'objet de destination. Cela indique qu'une connexion sera établie entre les deux objets lorsque vous relâcherez le bouton de la souris.

Vous pouvez abandonner la connexion à tout moment pendant que vous faites glisser le chemin de connexion en appuyant sur la touche Esc.

Une capture d'écran montre comment connecter un widget à un autre en cliquant avec le bouton gauche de la souris sur le widget à connecter.Établissement d'une connexion

Le chemin de connexion change de forme au fur et à mesure que le curseur se déplace dans le formulaire. Lorsqu'il passe sur des objets, ceux-ci sont mis en surbrillance, ce qui indique qu'ils peuvent être utilisés dans une connexion de signal et d'encoche. Relâchez le bouton de la souris pour établir la connexion.

La boîte de dialogue Configurer la connexion (ci-dessous) s'affiche, indiquant les signaux de l'objet source et les emplacements de l'objet de destination que vous pouvez utiliser.

Capture d'écran de la fenêtre listant les signaux pouvant être émis entre deux widgets sélectionnés

Pour terminer la connexion, sélectionnez un signal de l'objet source et un emplacement de l'objet de destination, puis cliquez sur OK. Cliquez sur Annuler si vous souhaitez abandonner la connexion.

Remarque : si la case Afficher tous les signaux et tous les emplacements est cochée, tous les signaux disponibles de l'objet source seront affichés. Dans le cas contraire, les signaux et les emplacements hérités de QWidget seront masqués.

Vous pouvez établir autant de connexions que vous le souhaitez entre les objets du formulaire ; il est possible de connecter des signaux d'objets à des emplacements dans le formulaire lui-même. Par conséquent, les connexions de signaux et d'emplacements dans de nombreuses boîtes de dialogue peuvent être entièrement configurées à partir de Qt Widgets Designer.

Capture d'écran montrant une flèche provenant d'un widget qui suit le curseur pour choisir un widget qui reçoit les signaux.Connexion à un formulaire

Pour connecter un objet au formulaire lui-même, il suffit de placer le curseur sur le formulaire et de relâcher le bouton de la souris. Le point final de la connexion devient le symbole de la "terre" électrique.

Modifier et supprimer des connexions

Par défaut, les chemins de connexion sont créés avec deux étiquettes qui indiquent le signal et l'emplacement impliqués dans la connexion. Ces étiquettes sont généralement orientées le long de la ligne de connexion. Vous pouvez les déplacer à l'intérieur de leurs widgets hôtes en faisant glisser le carré rouge à chaque extrémité du chemin de connexion.

Capture d'écran de l'éditeur de signaux et de slots de Qt Designer montrant des connexions entre un okButton et un cancelButton où le okButton et le cancelbutton envoient un signal "clicked()". Le bouton ok déclenche la fonction "accept()" et le bouton cancel "reject()"L'éditeur de signaux et d'emplacements

Le signal et l'emplacement utilisés dans une connexion peuvent être modifiés après sa configuration. Lorsqu'une connexion est configurée, elle devient visible dans l'éditeur de signaux et d'emplacements de Qt Widgets Designer, où elle peut être modifiée. Vous pouvez également modifier les connexions signal/emplacement en double-cliquant sur le chemin de connexion ou sur l'une de ses étiquettes pour afficher la boîte de dialogue de connexion.

Capture d'écran montrant le mode d'édition des connexions permettant de modifier les signaux entre deux widgetsSuppression de connexions

L'ensemble de la connexion peut être sélectionné en cliquant sur l'un de ses segments de chemin. Une fois sélectionnée, une connexion peut être supprimée à l'aide de la touche Suppr, ce qui garantit qu'elle ne sera pas configurée dans le fichier de l'interface utilisateur.

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