Sur cette page

QDesignerFormWindowManagerInterface Class

La classe QDesignerFormWindowManagerInterface vous permet de manipuler la collection de fenêtres de formulaire dans Qt Widgets Designer, et de contrôler les actions d'édition de formulaire de Qt Widgets Designer. Plus d'informations...

En-tête : #include <QDesignerFormWindowManagerInterface>
CMake : find_package(Qt6 REQUIRED COMPONENTS Designer)
target_link_libraries(mytarget PRIVATE Qt6::Designer)
qmake : QT += designer
Héritages : 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

Emplacements 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

QDesignerFormWindowManagerInterface n'est pas destiné à être instancié directement. Qt Widgets Designer utilise le gestionnaire de fenêtres de formulaire pour contrôler les différentes fenêtres de formulaire dans son espace de travail. Vous pouvez récupérer une interface du gestionnaire de fenêtres de formulaire de Qt Widgets Designer à l'aide de la fonction QDesignerFormEditorInterface::formWindowManager(). Par exemple, lors de l'implémentation d'un plugin de widget personnalisé :

        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 sur l'objet QDesignerFormEditorInterface actuel de Qt Widgets Designer(formEditor dans l'exemple ci-dessus) est fourni par le paramètre de la fonction QDesignerCustomWidgetInterface::initialize(). Vous devez sous-classer la fonction 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 que le gestionnaire maintient, en utilisant l'emplacement addFormWindow(). Elle fournit également la fonction formWindowCount() qui renvoie le nombre de fenêtres de formulaire actuellement sous le contrôle du 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 maintenir, et le slot setActiveFormWindow() vous permet de changer le focus de la fenêtre de formulaire dans l'espace de travail de Qt Widgets Designer.

En outre, QDesignerFormWindowManagerInterface contient une collection de fonctions qui vous permettent d'intervenir et de contrôler les actions d'édition de formulaire de Qt Widgets Designer. Toutes ces fonctions renvoient l'action originale, ce qui permet de propager la fonction après l'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 les signaux ont pour paramètre la fenêtre de formulaire en question.

Voir également QDesignerFormEditorInterface et QDesignerFormWindowInterface.

Documentation sur les types de membres

enum QDesignerFormWindowManagerInterface::Action

Spécifie une action de Qt Widgets Designer.

ConstanteValeurDescription de l'action
QDesignerFormWindowManagerInterface::CutAction100Coupe du presse-papiers
QDesignerFormWindowManagerInterface::CopyAction101Copier le presse-papiers
QDesignerFormWindowManagerInterface::PasteAction102Coller du presse-papiers
QDesignerFormWindowManagerInterface::DeleteAction103Supprimer le presse-papiers
QDesignerFormWindowManagerInterface::SelectAllAction104Sélectionner tout
QDesignerFormWindowManagerInterface::LowerAction200Abaisser le widget actuel
QDesignerFormWindowManagerInterface::RaiseAction201Augmenter le widget actuel
QDesignerFormWindowManagerInterface::UndoAction300Annuler
QDesignerFormWindowManagerInterface::RedoAction301Rétablir
QDesignerFormWindowManagerInterface::HorizontalLayoutAction400Disposer en utilisant QHBoxLayout
QDesignerFormWindowManagerInterface::VerticalLayoutAction401Disposer en utilisant QVBoxLayout
QDesignerFormWindowManagerInterface::SplitHorizontalAction402Disposer à l'horizontale QSplitter
QDesignerFormWindowManagerInterface::SplitVerticalAction403Disposition verticale QSplitter
QDesignerFormWindowManagerInterface::GridLayoutAction404Modifier à l'aide de QGridLayout
QDesignerFormWindowManagerInterface::FormLayoutAction405Disposition à l'aide de QFormLayout
QDesignerFormWindowManagerInterface::BreakLayoutAction406Interrompre la mise en page existante
QDesignerFormWindowManagerInterface::AdjustSizeAction407Ajuster la taille
QDesignerFormWindowManagerInterface::SimplifyLayoutAction408Simplifier QGridLayout ou QFormLayout
QDesignerFormWindowManagerInterface::DefaultPreviewAction500Créer un aperçu dans le style par défaut
QDesignerFormWindowManagerInterface::FormWindowSettingsDialogAction600Afficher une boîte de dialogue avec les paramètres du formulaire

Voir aussi action().

enum QDesignerFormWindowManagerInterface::ActionGroup

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

ConstanteValeurDescription du groupe d'action
QDesignerFormWindowManagerInterface::StyledPreviewActionGroup100Groupe d'actions contenant des actions de prévisualisation stylisée

Voir également actionGroup().

Documentation des fonctions membres

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

Construit une interface avec l'adresse parent pour le gestionnaire de fenêtres du formulaire.

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

Détruit l'interface du gestionnaire de fenêtres de formulaire.

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

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

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

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

Renvoie le groupe d'action spécifié par la valeur de l'énumération actionGroup.

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

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

Voir aussi 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 de Qt Widgets Designer a changé. Un pointeur sur la fenêtre active formWindow est transmis comme argument.

Voir aussi activeFormWindow().

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

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

Voir aussi formWindowAdded().

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

Fermer tous les aperçus actuellement ouverts.

Voir aussi showPreview().

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

Renvoie un pointeur sur l'objet Qt Widgets Designer's courant QDesignerFormEditorInterface.

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

Crée une fenêtre de formulaire avec l'adresse parent et la fenêtre flags.

Voir aussi addFormWindow().

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

Crée un pixmap représentant l'aperçu du formulaire actif.

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

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

Voir aussi 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 formulaire de Qt Widgets Designer. Un pointeur sur la nouvelle fenêtre formWindow est transmis en tant qu'argument.

Voir aussi 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 de Qt Widgets Designer.

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

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

Voir aussi 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 des fenêtres, etc. en conséquence. Un pointeur sur le site formWindow est transmis en tant qu'argument.

Voir aussi FormWindowSettingsDialogAction.

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

Supprime la fenêtre formWindow de la collection de fenêtres gérée par le gestionnaire de fenêtres de formulaire de Qt Widgets Designer.

Voir aussi formWindow() et formWindowRemoved().

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

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

Voir aussi activeFormWindow() et activeFormWindowChanged().

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

Ouvre une boîte de dialogue affichant les plugins chargés par Qt Widgets Designer's et ses échecs de chargement de plugins.

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

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

Voir aussi 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.