Auf dieser Seite

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.

KonstanteWertBeschreibung
QDesignerFormWindowManagerInterface::CutAction100Zwischenablage Ausschneiden
QDesignerFormWindowManagerInterface::CopyAction101Zwischenablage Ausschneiden
QDesignerFormWindowManagerInterface::PasteAction102Zwischenablage einfügen
QDesignerFormWindowManagerInterface::DeleteAction103Aus der Zwischenablage löschen
QDesignerFormWindowManagerInterface::SelectAllAction104Alles auswählen
QDesignerFormWindowManagerInterface::LowerAction200Aktuelles Widget nach unten verschieben
QDesignerFormWindowManagerInterface::RaiseAction201Aktuelles Widget nach oben verschieben
QDesignerFormWindowManagerInterface::UndoAction300Rückgängig
QDesignerFormWindowManagerInterface::RedoAction301Wiederholen
QDesignerFormWindowManagerInterface::HorizontalLayoutAction400Layout erstellen mit QHBoxLayout
QDesignerFormWindowManagerInterface::VerticalLayoutAction401Anordnen mit QVBoxLayout
QDesignerFormWindowManagerInterface::SplitHorizontalAction402Horizontal anordnen QSplitter
QDesignerFormWindowManagerInterface::SplitVerticalAction403Vertikal anordnen QSplitter
QDesignerFormWindowManagerInterface::GridLayoutAction404Anordnung mit QGridLayout
QDesignerFormWindowManagerInterface::FormLayoutAction405Anordnung mit QFormLayout
QDesignerFormWindowManagerInterface::BreakLayoutAction406Vorhandenes Layout aufbrechen
QDesignerFormWindowManagerInterface::AdjustSizeAction407Größe anpassen
QDesignerFormWindowManagerInterface::SimplifyLayoutAction408QGridLayout vereinfachen oder QFormLayout
QDesignerFormWindowManagerInterface::DefaultPreviewAction500Vorschau im Standardstil erstellen
QDesignerFormWindowManagerInterface::FormWindowSettingsDialogAction600Dialogfeld mit Formulareinstellungen anzeigen

Siehe auch „ action“ ().

enum QDesignerFormWindowManagerInterface::ActionGroup

Legt eine Aktionsgruppe v Qt Widgets -Designer fest.

KonstanteWertBeschreibung
QDesignerFormWindowManagerInterface::StyledPreviewActionGroup100Aktionsgruppe 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.