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