Sur cette page

QDesignerFormWindowManagerInterface Class

La classe `QDesignerFormWindowManagerInterface` vous permet de manipuler l'ensemble des fenêtres de formulaire dans le concepteur d'Qt Widgets, et de contrôler les actions d'édition de formulaires du concepteur d'Qt Widgets. En savoir plus...

En-tête : #include <QDesignerFormWindowManagerInterface>
CMake : find_package(Qt6 REQUIRED COMPONENTS Designer)
target_link_libraries(mytarget PRIVATE Qt6::Designer)
qmake : QT += designer
Hérite de : QObject

Types publics

enum Action { CutAction, CopyAction, PasteAction, DeleteAction, SelectAllAction, …, FormWindowSettingsDialogAction }
enum ActionGroup { StyledPreviewActionGroup }

Fonctions publiques

QDesignerFormWindowManagerInterface(QObject *parent = nullptr)
virtual ~QDesignerFormWindowManagerInterface() override
virtual QAction *action(QDesignerFormWindowManagerInterface::Action action) const = 0
virtual QActionGroup *actionGroup(QDesignerFormWindowManagerInterface::ActionGroup actionGroup) const = 0
virtual QDesignerFormWindowInterface *activeFormWindow() const = 0
virtual QDesignerFormEditorInterface *core() const = 0
virtual QDesignerFormWindowInterface *createFormWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) = 0
virtual QPixmap createPreviewPixmap() const = 0
virtual QDesignerFormWindowInterface *formWindow(int index) const = 0
virtual int formWindowCount() const = 0

Slots publics

virtual void addFormWindow(QDesignerFormWindowInterface *formWindow) = 0
virtual void closeAllPreviews() = 0
virtual void removeFormWindow(QDesignerFormWindowInterface *formWindow) = 0
virtual void setActiveFormWindow(QDesignerFormWindowInterface *formWindow) = 0
virtual void showPluginDialog() = 0
virtual void showPreview() = 0

Signaux

void activeFormWindowChanged(QDesignerFormWindowInterface *formWindow)
void formWindowAdded(QDesignerFormWindowInterface *formWindow)
void formWindowRemoved(QDesignerFormWindowInterface *formWindow)
void formWindowSettingsChanged(QDesignerFormWindowInterface *formWindow)

Description détaillée

L'interface `QDesignerFormWindowManagerInterface` n'est pas destinée à être instanciée directement. Le Designer d'Qt Widgets utilise le gestionnaire de fenêtres de formulaire pour contrôler les différentes fenêtres de formulaire de son espace de travail. Vous pouvez récupérer une interface vers le gestionnaire de fenêtres de formulaire du Designer d'Qt Widgets à l'aide de la fonction ` QDesignerFormEditorInterface::formWindowManager()`. Par exemple :

        auto *manager = formEditor->formWindowManager();
        auto *formWindow = manager->formWindow(0);

        manager->setActiveFormWindow(formWindow);

Lors de l’implémentation d’un plugin de widget personnalisé, un pointeur vers l’objet ` QDesignerFormEditorInterface ` actuel d’ Qt Widgets Designer (`formEditor ` dans l’exemple ci-dessus) est fourni par le paramètre de la fonction ` QDesignerCustomWidgetInterface::initialize()`. Vous devez créer une sous-classe de ` QDesignerCustomWidgetInterface ` pour exposer votre plugin à Qt Widgets Designer.

L’interface du gestionnaire de fenêtres de formulaire fournit la fonction ` createFormWindow()` qui vous permet de créer une nouvelle fenêtre de formulaire que vous pouvez ajouter à la collection de fenêtres de formulaire gérée par le gestionnaire, à l’aide du slot ` addFormWindow()`. Elle fournit également la fonction formWindowCount() qui renvoie le nombre de fenêtres de formulaire actuellement gérées par le gestionnaire, la fonction formWindow() qui renvoie la fenêtre de formulaire associée à un index donné, et la fonction activeFormWindow() qui renvoie la fenêtre de formulaire actuellement sélectionnée. Le slot « removeFormWindow() » vous permet de réduire le nombre de fenêtres de formulaire que le gestionnaire doit gérer, et le slot « setActiveFormWindow() » vous permet de modifier la fenêtre de formulaire active dans l’espace de travail de l’ Qt Widgets Designer.

De plus, l’interface `QDesignerFormWindowManagerInterface` contient un ensemble de fonctions qui vous permettent d’intervenir et de contrôler les actions d’édition de formulaires dans le concepteur d’ Qt Widgets. Toutes ces fonctions renvoient l’action d’origine, ce qui permet de propager la fonction plus loin après intervention.

Enfin, l’interface fournit trois signaux qui sont émis respectivement lorsqu’une fenêtre de formulaire est ajoutée, lorsque la fenêtre de formulaire actuellement sélectionnée change ou lorsqu’une fenêtre de formulaire est supprimée. Tous ces signaux ont pour paramètre la fenêtre de formulaire concernée.

Voir également QDesignerFormEditorInterface et QDesignerFormWindowInterface.

Documentation sur les types de membres

enum QDesignerFormWindowManagerInterface::Action

Spécifie une action de l'outil de conception d'Qt Widgets.

ConstanteValeurDescription
QDesignerFormWindowManagerInterface::CutAction100Presse-papiers Couper
QDesignerFormWindowManagerInterface::CopyAction101Copier dans le presse-papiers
QDesignerFormWindowManagerInterface::PasteAction102Coller dans le presse-papiers
QDesignerFormWindowManagerInterface::DeleteAction103Supprimer du presse-papiers
QDesignerFormWindowManagerInterface::SelectAllAction104Tout sélectionner
QDesignerFormWindowManagerInterface::LowerAction200Abaisser le widget actuel
QDesignerFormWindowManagerInterface::RaiseAction201Faire passer le widget actuel au niveau supérieur
QDesignerFormWindowManagerInterface::UndoAction300Annuler
QDesignerFormWindowManagerInterface::RedoAction301Refaire
QDesignerFormWindowManagerInterface::HorizontalLayoutAction400Disposer en utilisant QHBoxLayout
QDesignerFormWindowManagerInterface::VerticalLayoutAction401Mise en page à l'aide de QVBoxLayout
QDesignerFormWindowManagerInterface::SplitHorizontalAction402Disposer horizontalement QSplitter
QDesignerFormWindowManagerInterface::SplitVerticalAction403Mise en page verticale QSplitter
QDesignerFormWindowManagerInterface::GridLayoutAction404Mise en page à l'aide de QGridLayout
QDesignerFormWindowManagerInterface::FormLayoutAction405Mise en page à l'aide de QFormLayout
QDesignerFormWindowManagerInterface::BreakLayoutAction406Modifier la mise en page existante
QDesignerFormWindowManagerInterface::AdjustSizeAction407Ajuster la taille
QDesignerFormWindowManagerInterface::SimplifyLayoutAction408Simplifier l'QGridLayout ou QFormLayout
QDesignerFormWindowManagerInterface::DefaultPreviewAction500Créer un aperçu dans le style par défaut
QDesignerFormWindowManagerInterface::FormWindowSettingsDialogAction600Afficher la boîte de dialogue avec les paramètres du formulaire

Voir aussi action().

enum QDesignerFormWindowManagerInterface::ActionGroup

Spécifie un groupe d'actions de Qt Widgets Designer.

ConstanteValeurDescription
QDesignerFormWindowManagerInterface::StyledPreviewActionGroup100Groupe d'actions contenant des actions d'aperçu stylisé

Voir aussi actionGroup().

Documentation des fonctions membres

[explicit] QDesignerFormWindowManagerInterface::QDesignerFormWindowManagerInterface(QObject *parent = nullptr)

Crée une interface avec l'parent on fournie pour le gestionnaire de fenêtres du formulaire.

[override virtual noexcept] QDesignerFormWindowManagerInterface::~QDesignerFormWindowManagerInterface()

Supprime l'interface du gestionnaire de fenêtres de formulaires.

[pure virtual] QAction *QDesignerFormWindowManagerInterface::action(QDesignerFormWindowManagerInterface::Action action) const

Renvoie l'action spécifiée par la valeur d'énumération action.

Remplace les accesseurs d'action de Qt 4.X.

[pure virtual] QActionGroup *QDesignerFormWindowManagerInterface::actionGroup(QDesignerFormWindowManagerInterface::ActionGroup actionGroup) const

Renvoie le groupe d'actions spécifié par la valeur d'énumération « actionGroup ».

[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::activeFormWindow() const

Renvoie la fenêtre du formulaire actuellement active dans l'espace de travail d'Qt Widgets Designer.

Voir également setActiveFormWindow() et removeFormWindow().

[signal] void QDesignerFormWindowManagerInterface::activeFormWindowChanged(QDesignerFormWindowInterface *formWindow)

Ce signal est émis lorsque le contenu de la fenêtre de formulaire actuellement active dans l'espace de travail d'Qt Widgets Designer a changé. Un pointeur vers l'formWindow e actuellement active est transmis en tant qu'argument.

Voir également activeFormWindow().

[pure virtual slot] void QDesignerFormWindowManagerInterface::addFormWindow(QDesignerFormWindowInterface *formWindow)

Ajoute l'formWindow e indiquée à la collection de fenêtres gérée par le gestionnaire de fenêtres de formulaires d'Qt Widgets Designer.

Voir également formWindowAdded().

[pure virtual slot] void QDesignerFormWindowManagerInterface::closeAllPreviews()

Fermer tous les aperçus actuellement ouverts.

Voir aussi showPreview().

[pure virtual] QDesignerFormEditorInterface *QDesignerFormWindowManagerInterface::core() const

Qt Widgets Renvoie un pointeur vers l'objet « QDesignerFormEditorInterface » ( ) actuel de Designer.

[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::createFormWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Crée une fenêtre de formulaire avec l'parent spécifiée et l'flags de fenêtre indiquée.

Voir aussi addFormWindow().

[pure virtual] QPixmap QDesignerFormWindowManagerInterface::createPreviewPixmap() const

Crée une image bitmap représentant l'aperçu du formulaire actuellement actif.

[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::formWindow(int index) const

Renvoie la fenêtre du formulaire à l'adresse index indiquée.

Voir également setActiveFormWindow() et removeFormWindow().

[signal] void QDesignerFormWindowManagerInterface::formWindowAdded(QDesignerFormWindowInterface *formWindow)

Ce signal est émis lorsqu'une nouvelle fenêtre de formulaire est ajoutée à la collection de fenêtres gérée par le gestionnaire de fenêtres de formulaires d'Qt Widgets Designer. Un pointeur vers la nouvelle fenêtre de formulaire ( formWindow ) est transmis en tant qu'argument.

Voir également addFormWindow() et setActiveFormWindow().

[pure virtual] int QDesignerFormWindowManagerInterface::formWindowCount() const

Renvoie le nombre de fenêtres de formulaire gérées par le gestionnaire de fenêtres de formulaire d'Qt Widgets Designer.

[signal] void QDesignerFormWindowManagerInterface::formWindowRemoved(QDesignerFormWindowInterface *formWindow)

Ce signal est émis lorsqu'une fenêtre de formulaire est retirée de la collection de fenêtres gérée par le gestionnaire de fenêtres de formulaire d'Qt Widgets Designer. Un pointeur vers l'formWindow e retirée est transmis en tant qu'argument.

Voir également removeFormWindow().

[signal] void QDesignerFormWindowManagerInterface::formWindowSettingsChanged(QDesignerFormWindowInterface *formWindow)

Ce signal est émis lorsque les paramètres de la fenêtre du formulaire changent. Il peut être utilisé pour mettre à jour les titres de fenêtre, etc., en conséquence. Un pointeur vers l'formWindow est transmis en tant qu'argument.

Voir également FormWindowSettingsDialogAction.

[pure virtual slot] void QDesignerFormWindowManagerInterface::removeFormWindow(QDesignerFormWindowInterface *formWindow)

Supprime l'formWindow on indiquée de la collection de fenêtres gérée par le gestionnaire de fenêtres de formulaires d'Qt Widgets Designer.

Voir également ` formWindow()` et ` formWindowRemoved()`.

[pure virtual slot] void QDesignerFormWindowManagerInterface::setActiveFormWindow(QDesignerFormWindowInterface *formWindow)

Définit l'formWindow spécifiée comme fenêtre de formulaire actuellement active dans l'espace de travail d'Qt Widgets Designer.

Voir également ` activeFormWindow()` et ` activeFormWindowChanged()`.

[pure virtual slot] void QDesignerFormWindowManagerInterface::showPluginDialog()

Ouvre une boîte de dialogue affichant les plugins chargés par Qt Widgets Designer ainsi que les échecs de chargement de ces derniers.

[pure virtual slot] void QDesignerFormWindowManagerInterface::showPreview()

Afficher un aperçu du formulaire actuel en utilisant les paramètres par défaut.

Voir également closeAllPreviews().

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