QDesignerFormWindowManagerInterface Class
Mit der Klasse „QDesignerFormWindowManagerInterface“ können Sie die Sammlung von Formularfenstern im „ Qt Widgets “-Designer bearbeiten und die Aktionen zur Formularbearbeitung im „ Qt Widgets “-Designer steuern. Mehr...
| Überschrift: | #include <QDesignerFormWindowManagerInterface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Designer) target_link_libraries(mytarget PRIVATE Qt6::Designer) |
| qmake: | QT += designer |
| Erbt von: | QObject |
Öffentliche Typen
| enum | Action { CutAction, CopyAction, PasteAction, DeleteAction, SelectAllAction, …, FormWindowSettingsDialogAction } |
| enum | ActionGroup { StyledPreviewActionGroup } |
Öffentliche Funktionen
| 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 |
Öffentliche Slots
| 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 |
Signale
| void | activeFormWindowChanged(QDesignerFormWindowInterface *formWindow) |
| void | formWindowAdded(QDesignerFormWindowInterface *formWindow) |
| void | formWindowRemoved(QDesignerFormWindowInterface *formWindow) |
| void | formWindowSettingsChanged(QDesignerFormWindowInterface *formWindow) |
Ausführliche Beschreibung
„QDesignerFormWindowManagerInterface“ ist nicht für die direkte Instanziierung vorgesehen. „ Qt Widgets Designer“ verwendet den Formularfenster-Manager zur Steuerung der verschiedenen Formularfenster in seinem Arbeitsbereich. Mit der Funktion „ QDesignerFormEditorInterface::formWindowManager()“ können Sie eine Schnittstelle zum Formularfenster-Manager von „ Qt Widgets Designer“ abrufen. Beispiel:
auto *manager = formEditor->formWindowManager();
auto *formWindow = manager->formWindow(0);
manager->setActiveFormWindow(formWindow);Bei der Implementierung eines benutzerdefinierten Widget-Plugins wird ein Zeiger auf das aktuelle ` QDesignerFormEditorInterface `-Objekt des „ Qt Widgets “-Designers (im obigen Beispiel `formEditor `) über den Parameter der Funktion ` QDesignerCustomWidgetInterface::initialize()` bereitgestellt. Sie müssen eine Unterklasse von ` QDesignerCustomWidgetInterface ` erstellen, um Ihr Plugin für den „ Qt Widgets “-Designer verfügbar zu machen.
Die Schnittstelle des Formularfenster-Managers stellt die Funktion ` createFormWindow()` bereit, mit der Sie ein neues Formularfenster erstellen können, das Sie mithilfe des Slots ` addFormWindow()` zur Sammlung der vom Manager verwalteten Formularfenster hinzufügen können. Außerdem bietet er die Funktion „ formWindowCount()“, die die Anzahl der derzeit vom Manager verwalteten Formularfenster zurückgibt, die Funktion „ formWindow()“, die das mit einem bestimmten Index verknüpfte Formularfenster zurückgibt, sowie die Funktion „ activeFormWindow()“, die das aktuell ausgewählte Formularfenster zurückgibt. Der Slot „ removeFormWindow()“ ermöglicht es Ihnen, die Anzahl der Formularfenster zu reduzieren, die der Manager verwalten muss, und der Slot „ setActiveFormWindow()“ ermöglicht es Ihnen, den Fokus des Formularfensters im Arbeitsbereich des „ Qt Widgets “-Designers zu ändern.
Darüber hinaus enthält `QDesignerFormWindowManagerInterface` eine Sammlung von Funktionen, mit denen Sie in die Formularbearbeitungsaktionen des ` Qt Widgets `-Designers eingreifen und diese steuern können. Alle diese Funktionen geben die ursprüngliche Aktion zurück, sodass die Funktion nach dem Eingriff weiterverarbeitet werden kann.
Schließlich stellt die Schnittstelle drei Signale bereit, die jeweils dann ausgelöst werden, wenn ein Formularfenster hinzugefügt wird, wenn sich das aktuell ausgewählte Formularfenster ändert oder wenn ein Formularfenster entfernt wird. Alle Signale übergeben das betreffende Formularfenster als Parameter.
Siehe auch QDesignerFormEditorInterface und QDesignerFormWindowInterface.
Dokumentation zu Mitgliedstypen
enum QDesignerFormWindowManagerInterface::Action
Legt eine Aktion des „ Qt Widgets “-Designers fest.
| Konstante | Wert | Beschreibung |
|---|---|---|
QDesignerFormWindowManagerInterface::CutAction | 100 | Zwischenablage Ausschneiden |
QDesignerFormWindowManagerInterface::CopyAction | 101 | Zwischenablage Ausschneiden |
QDesignerFormWindowManagerInterface::PasteAction | 102 | Zwischenablage einfügen |
QDesignerFormWindowManagerInterface::DeleteAction | 103 | Aus der Zwischenablage löschen |
QDesignerFormWindowManagerInterface::SelectAllAction | 104 | Alles auswählen |
QDesignerFormWindowManagerInterface::LowerAction | 200 | Aktuelles Widget nach unten verschieben |
QDesignerFormWindowManagerInterface::RaiseAction | 201 | Aktuelles Widget nach oben verschieben |
QDesignerFormWindowManagerInterface::UndoAction | 300 | Rückgängig |
QDesignerFormWindowManagerInterface::RedoAction | 301 | Wiederholen |
QDesignerFormWindowManagerInterface::HorizontalLayoutAction | 400 | Layout erstellen mit QHBoxLayout |
QDesignerFormWindowManagerInterface::VerticalLayoutAction | 401 | Anordnen mit QVBoxLayout |
QDesignerFormWindowManagerInterface::SplitHorizontalAction | 402 | Horizontal anordnen QSplitter |
QDesignerFormWindowManagerInterface::SplitVerticalAction | 403 | Vertikal anordnen QSplitter |
QDesignerFormWindowManagerInterface::GridLayoutAction | 404 | Anordnung mit QGridLayout |
QDesignerFormWindowManagerInterface::FormLayoutAction | 405 | Anordnung mit QFormLayout |
QDesignerFormWindowManagerInterface::BreakLayoutAction | 406 | Vorhandenes Layout aufbrechen |
QDesignerFormWindowManagerInterface::AdjustSizeAction | 407 | Größe anpassen |
QDesignerFormWindowManagerInterface::SimplifyLayoutAction | 408 | QGridLayout vereinfachen oder QFormLayout |
QDesignerFormWindowManagerInterface::DefaultPreviewAction | 500 | Vorschau im Standardstil erstellen |
QDesignerFormWindowManagerInterface::FormWindowSettingsDialogAction | 600 | Dialogfeld mit Formulareinstellungen anzeigen |
Siehe auch „ action“ ().
enum QDesignerFormWindowManagerInterface::ActionGroup
Legt eine Aktionsgruppe v Qt Widgets -Designer fest.
| Konstante | Wert | Beschreibung |
|---|---|---|
QDesignerFormWindowManagerInterface::StyledPreviewActionGroup | 100 | Aktionsgruppe mit gestylten Vorschau-Aktionen |
Siehe auch actionGroup().
Dokumentation der Mitgliedsfunktionen
[explicit] QDesignerFormWindowManagerInterface::QDesignerFormWindowManagerInterface(QObject *parent = nullptr)
Erstellt eine Schnittstelle mit der angegebenen „ parent “ für den Formular-Fenstermanager.
[override virtual noexcept] QDesignerFormWindowManagerInterface::~QDesignerFormWindowManagerInterface()
Löscht die Benutzeroberfläche des Formular-Fenstermanagers.
[pure virtual] QAction *QDesignerFormWindowManagerInterface::action(QDesignerFormWindowManagerInterface::Action action) const
Gibt die durch den Enumerationswert „ action “ angegebene Aktion zurück.
Ersetzt die Aktions-Accessoren von Qt 4.X.
[pure virtual] QActionGroup *QDesignerFormWindowManagerInterface::actionGroup(QDesignerFormWindowManagerInterface::ActionGroup actionGroup) const
Gibt die Aktionsgruppe zurück, die durch den Aufzählungswert „ actionGroup “ angegeben ist.
[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::activeFormWindow() const
Gibt das derzeit aktive Formularfenster im Arbeitsbereich des „ Qt Widgets “-Designers zurück.
Siehe auch „ setActiveFormWindow()“ und „ removeFormWindow()“.
[signal] void QDesignerFormWindowManagerInterface::activeFormWindowChanged(QDesignerFormWindowInterface *formWindow)
Dieses Signal wird ausgelöst, wenn sich der Inhalt des aktuell aktiven Formularfensters im Arbeitsbereich des „ Qt Widgets Designer“ geändert hat. Als Argument wird ein Zeiger auf das aktuell aktive „ formWindow “ übergeben.
Siehe auch activeFormWindow().
[pure virtual slot] void QDesignerFormWindowManagerInterface::addFormWindow(QDesignerFormWindowInterface *formWindow)
Fügt die angegebene „ formWindow “ zur Sammlung von Fenstern hinzu, die vom Formular-Fenstermanager des „ Qt Widgets Designer“ verwaltet wird.
Siehe auch formWindowAdded().
[pure virtual slot] void QDesignerFormWindowManagerInterface::closeAllPreviews()
Schließen Sie alle derzeit geöffneten Vorschauen.
Siehe auch „ showPreview“ ().
[pure virtual] QDesignerFormEditorInterface *QDesignerFormWindowManagerInterface::core() const
Gibt einen Zeiger auf das aktuelle „ QDesignerFormEditorInterface “-Objekt des „ Qt Widgets “-Designers zurück.
[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::createFormWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Erstellt ein Formularfenster mit dem angegebenen Formular-ID- parent und der angegebenen Fenster- flags.
Siehe auch ` addFormWindow()`().
[pure virtual] QPixmap QDesignerFormWindowManagerInterface::createPreviewPixmap() const
Erstellt eine Pixmap, die die Vorschau des derzeit aktiven Formulars darstellt.
[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::formWindow(int index) const
Gibt das Formularfenster an der angegebenen Adresse index zurück.
Siehe auch ` setActiveFormWindow()` und ` removeFormWindow()`.
[signal] void QDesignerFormWindowManagerInterface::formWindowAdded(QDesignerFormWindowInterface *formWindow)
Dieses Signal wird ausgelöst, wenn ein neues Formularfenster zur Sammlung von Fenstern hinzugefügt wird, die vom Formularfenster-Manager des „ Qt Widgets Designer“ verwaltet wird. Als Argument wird ein Zeiger auf das neue „ formWindow “ übergeben.
Siehe auch „ addFormWindow()“ und „ setActiveFormWindow()“.
[pure virtual] int QDesignerFormWindowManagerInterface::formWindowCount() const
Gibt die Anzahl der Formularfenster zurück, die vom Formularfenster-Manager des „ Qt Widgets “-Designers verwaltet werden.
[signal] void QDesignerFormWindowManagerInterface::formWindowRemoved(QDesignerFormWindowInterface *formWindow)
Dieses Signal wird ausgelöst, wenn ein Formularfenster aus der Sammlung von Fenstern entfernt wird, die der Formularfenster-Manager des „ Qt Widgets Designer“ verwaltet. Als Argument wird ein Zeiger auf das entfernte „ formWindow “ übergeben.
Siehe auch removeFormWindow().
[signal] void QDesignerFormWindowManagerInterface::formWindowSettingsChanged(QDesignerFormWindowInterface *formWindow)
Dieses Signal wird ausgelöst, wenn sich die Einstellungen des Formularfensters ändern. Es kann verwendet werden, um beispielsweise Fenstertitel entsprechend anzupassen. Als Argument wird ein Zeiger auf das „ formWindow “ übergeben.
Siehe auch „ FormWindowSettingsDialogAction “.
[pure virtual slot] void QDesignerFormWindowManagerInterface::removeFormWindow(QDesignerFormWindowInterface *formWindow)
Entfernt das angegebene „ formWindow “ aus der Sammlung von Fenstern, die vom Formular-Fenstermanager des „ Qt Widgets Designer“ verwaltet wird.
Siehe auch „ formWindow()“ und „ formWindowRemoved()“.
[pure virtual slot] void QDesignerFormWindowManagerInterface::setActiveFormWindow(QDesignerFormWindowInterface *formWindow)
Legt das angegebene „ formWindow “ als derzeit aktives Formularfenster im Arbeitsbereich des „ Qt Widgets Designer“ fest.
Siehe auch ` activeFormWindow()` und ` activeFormWindowChanged()`.
[pure virtual slot] void QDesignerFormWindowManagerInterface::showPluginDialog()
Öffnet ein Dialogfeld, in dem die von „ Qt Widgets Designer“ geladenen Plugins sowie eventuelle Fehler beim Laden der Plugins angezeigt werden.
[pure virtual slot] void QDesignerFormWindowManagerInterface::showPreview()
Zeige eine Vorschau des aktuellen Formulars unter Verwendung der Standardparameter an.
Siehe auch ` 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.