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.
| Constante | Valeur | Description |
|---|---|---|
QDesignerFormWindowManagerInterface::CutAction | 100 | Presse-papiers Couper |
QDesignerFormWindowManagerInterface::CopyAction | 101 | Copier dans le presse-papiers |
QDesignerFormWindowManagerInterface::PasteAction | 102 | Coller dans le presse-papiers |
QDesignerFormWindowManagerInterface::DeleteAction | 103 | Supprimer du presse-papiers |
QDesignerFormWindowManagerInterface::SelectAllAction | 104 | Tout sélectionner |
QDesignerFormWindowManagerInterface::LowerAction | 200 | Abaisser le widget actuel |
QDesignerFormWindowManagerInterface::RaiseAction | 201 | Faire passer le widget actuel au niveau supérieur |
QDesignerFormWindowManagerInterface::UndoAction | 300 | Annuler |
QDesignerFormWindowManagerInterface::RedoAction | 301 | Refaire |
QDesignerFormWindowManagerInterface::HorizontalLayoutAction | 400 | Disposer en utilisant QHBoxLayout |
QDesignerFormWindowManagerInterface::VerticalLayoutAction | 401 | Mise en page à l'aide de QVBoxLayout |
QDesignerFormWindowManagerInterface::SplitHorizontalAction | 402 | Disposer horizontalement QSplitter |
QDesignerFormWindowManagerInterface::SplitVerticalAction | 403 | Mise en page verticale QSplitter |
QDesignerFormWindowManagerInterface::GridLayoutAction | 404 | Mise en page à l'aide de QGridLayout |
QDesignerFormWindowManagerInterface::FormLayoutAction | 405 | Mise en page à l'aide de QFormLayout |
QDesignerFormWindowManagerInterface::BreakLayoutAction | 406 | Modifier la mise en page existante |
QDesignerFormWindowManagerInterface::AdjustSizeAction | 407 | Ajuster la taille |
QDesignerFormWindowManagerInterface::SimplifyLayoutAction | 408 | Simplifier l'QGridLayout ou QFormLayout |
QDesignerFormWindowManagerInterface::DefaultPreviewAction | 500 | Créer un aperçu dans le style par défaut |
QDesignerFormWindowManagerInterface::FormWindowSettingsDialogAction | 600 | Afficher 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.
| Constante | Valeur | Description |
|---|---|---|
QDesignerFormWindowManagerInterface::StyledPreviewActionGroup | 100 | Groupe 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.