QDesignerFormWindowManagerInterface Class
Die Klasse QDesignerFormWindowManagerInterface ermöglicht es Ihnen, die Sammlung von Formularfenstern in Qt Widgets Designer zu manipulieren und die Formularbearbeitungsaktionen von Qt Widgets Designer zu steuern. Mehr...
| Kopfzeile: | #include <QDesignerFormWindowManagerInterface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Designer)target_link_libraries(mytarget PRIVATE Qt6::Designer) |
| qmake: | QT += designer |
| Vererbungen: | QObject |
Öffentliche Typen
| enum | Action { CutAction, CopyAction, PasteAction, DeleteAction, SelectAllAction, …, FormWindowSettingsDialogAction } |
| enum | ActionGroup { StyledPreviewActionGroup } |
Öffentliche Funktionen
| QDesignerFormWindowManagerInterface(QObject *parent = nullptr) | |
| virtual | ~QDesignerFormWindowManagerInterface() |
| 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) |
Detaillierte Beschreibung
QDesignerFormWindowManagerInterface ist nicht dazu gedacht, direkt instanziert zu werden. Qt Widgets Designer verwendet den Formularfenster-Manager, um die verschiedenen Formularfenster in seinem Arbeitsbereich zu steuern. Sie können eine Schnittstelle zu Qt Widgets Designer's Form Window Manager mit der QDesignerFormEditorInterface::formWindowManager() Funktion abrufen. Ein Beispiel:
auto *manager = formEditor->formWindowManager(); auto *formWindow = manager->formWindow(0); manager->setActiveFormWindow(formWindow);
Wenn Sie ein benutzerdefiniertes Widget-Plugin implementieren, wird ein Zeiger auf das aktuelle QDesignerFormEditorInterface -Objekt von Qt Widgets Designer (formEditor im obigen Beispiel) über den Parameter der Funktion QDesignerCustomWidgetInterface::initialize() bereitgestellt. Sie müssen die QDesignerCustomWidgetInterface unterklassifizieren, um Ihr Plugin dem Qt Widgets Designer zur Verfügung zu stellen.
Die Schnittstelle des Formularfenstermanagers bietet die Funktion createFormWindow(), mit der Sie ein neues Formularfenster erstellen können, das Sie der Sammlung von Formularfenstern hinzufügen können, die der Manager unter Verwendung des addFormWindow()-Slots verwaltet. Sie bietet auch die Funktion formWindowCount(), die die Anzahl der Formularfenster zurückgibt, die sich derzeit unter der Kontrolle des Managers befinden, die Funktion formWindow(), die das Formularfenster zurückgibt, das einem bestimmten Index zugeordnet ist, und die Funktion activeFormWindow(), die das derzeit ausgewählte Formularfenster zurückgibt. Der removeFormWindow() Slot erlaubt es Ihnen, die Anzahl der Formularfenster zu reduzieren, die der Manager verwalten muss, und der setActiveFormWindow() Slot erlaubt es Ihnen, den Fokus des Formularfensters im Qt Widgets Designer Arbeitsbereich zu ändern.
Darüber hinaus enthält QDesignerFormWindowManagerInterface eine Sammlung von Funktionen, mit denen Sie in die Formularbearbeitungsaktionen von Qt Widgets Designer eingreifen und diese steuern können. Alle diese Funktionen geben die ursprüngliche Aktion zurück, so dass es möglich ist, die Funktion nach dem Eingriff weiter zu propagieren.
Schließlich bietet die Schnittstelle drei Signale, die ausgegeben werden, wenn ein Formularfenster hinzugefügt wird, wenn sich das aktuell ausgewählte Formularfenster ändert bzw. wenn ein Formularfenster entfernt wird. Alle Signale haben das betreffende Formularfenster als Parameter.
Siehe auch QDesignerFormEditorInterface und QDesignerFormWindowInterface.
Dokumentation der Mitgliedstypen
enum QDesignerFormWindowManagerInterface::Action
Gibt eine Aktion von Qt Widgets Designer an.
| Konstante | Wert | Beschreibung |
|---|---|---|
QDesignerFormWindowManagerInterface::CutAction | 100 | Zwischenablage Ausschneiden |
QDesignerFormWindowManagerInterface::CopyAction | 101 | Zwischenablage Kopieren |
QDesignerFormWindowManagerInterface::PasteAction | 102 | Zwischenablage Einfügen |
QDesignerFormWindowManagerInterface::DeleteAction | 103 | Zwischenablage Löschen |
QDesignerFormWindowManagerInterface::SelectAllAction | 104 | Alles auswählen |
QDesignerFormWindowManagerInterface::LowerAction | 200 | Aktuelles Widget absenken |
QDesignerFormWindowManagerInterface::RaiseAction | 201 | Aktuelles Widget anheben |
QDesignerFormWindowManagerInterface::UndoAction | 300 | Rückgängig |
QDesignerFormWindowManagerInterface::RedoAction | 301 | Wiederholen |
QDesignerFormWindowManagerInterface::HorizontalLayoutAction | 400 | Auslegen mit QHBoxLayout |
QDesignerFormWindowManagerInterface::VerticalLayoutAction | 401 | Auslegen mit QVBoxLayout |
QDesignerFormWindowManagerInterface::SplitHorizontalAction | 402 | Horizontal auslegen QSplitter |
QDesignerFormWindowManagerInterface::SplitVerticalAction | 403 | Vertikal auslegen QSplitter |
QDesignerFormWindowManagerInterface::GridLayoutAction | 404 | Auslegen mit QGridLayout |
QDesignerFormWindowManagerInterface::FormLayoutAction | 405 | Auslegen mit QFormLayout |
QDesignerFormWindowManagerInterface::BreakLayoutAction | 406 | Vorhandenes Layout aufbrechen |
QDesignerFormWindowManagerInterface::AdjustSizeAction | 407 | Größe anpassen |
QDesignerFormWindowManagerInterface::SimplifyLayoutAction | 408 | Vereinfachen QGridLayout oder QFormLayout |
QDesignerFormWindowManagerInterface::DefaultPreviewAction | 500 | Eine Vorschau im Standardstil erstellen |
QDesignerFormWindowManagerInterface::FormWindowSettingsDialogAction | 600 | Dialog mit Formulareinstellungen anzeigen |
Siehe auch action().
enum QDesignerFormWindowManagerInterface::ActionGroup
Gibt eine Aktionsgruppe von Qt Widgets Designer an.
| Konstante | Wert | Beschreibung |
|---|---|---|
QDesignerFormWindowManagerInterface::StyledPreviewActionGroup | 100 | Aktionsgruppe, die gestylte Vorschau-Aktionen enthält |
Siehe auch actionGroup().
Dokumentation der Mitgliedsfunktionen
[explicit] QDesignerFormWindowManagerInterface::QDesignerFormWindowManagerInterface(QObject *parent = nullptr)
Konstruiert eine Schnittstelle mit der angegebenen parent für den Formularfenster-Manager.
[virtual noexcept] QDesignerFormWindowManagerInterface::~QDesignerFormWindowManagerInterface()
Zerstört die Schnittstelle für den Formularfenster-Manager.
[pure virtual] QAction *QDesignerFormWindowManagerInterface::action(QDesignerFormWindowManagerInterface::Action action) const
Gibt die durch den Aufzählungswert action angegebene Aktion zurück.
Löscht die Aktions-Accessoren von Qt 4.X.
[pure virtual] QActionGroup *QDesignerFormWindowManagerInterface::actionGroup(QDesignerFormWindowManagerInterface::ActionGroup actionGroup) const
Gibt die durch den Aufzählungswert actionGroup angegebene Aktionsgruppe zurück.
[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::activeFormWindow() const
Gibt das derzeit aktive Formularfenster im Arbeitsbereich von Qt Widgets Designer zurück.
Siehe auch setActiveFormWindow() und removeFormWindow().
[signal] void QDesignerFormWindowManagerInterface::activeFormWindowChanged(QDesignerFormWindowInterface *formWindow)
Dieses Signal wird ausgegeben, wenn sich der Inhalt des gerade aktiven Formularfensters im Arbeitsbereich von Qt Widgets Designer geändert hat. Als Argument wird ein Zeiger auf das gerade aktive formWindow übergeben.
Siehe auch activeFormWindow().
[pure virtual slot] void QDesignerFormWindowManagerInterface::addFormWindow(QDesignerFormWindowInterface *formWindow)
Fügt das angegebene formWindow der Sammlung von Fenstern hinzu, die der Formularfenster-Manager von Qt Widgets Designer verwaltet.
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 von Qt Widgets Designer zurück.
[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::createFormWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Erzeugt ein Formularfenster mit dem angegebenen parent und dem angegebenen Fenster flags.
Siehe auch addFormWindow().
[pure virtual] QPixmap QDesignerFormWindowManagerInterface::createPreviewPixmap() const
Erzeugt eine Pixmap, die die Vorschau des gerade aktiven Formulars darstellt.
[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::formWindow(int index) const
Gibt das Formularfenster unter der angegebenen Adresse index zurück.
Siehe auch setActiveFormWindow() und removeFormWindow().
[signal] void QDesignerFormWindowManagerInterface::formWindowAdded(QDesignerFormWindowInterface *formWindow)
Dieses Signal wird ausgegeben, wenn ein neues Formularfenster zu der Sammlung von Fenstern hinzugefügt wird, die der Formularfenster-Manager von Qt Widgets Designer verwaltet. Ein Zeiger auf das neue formWindow wird als Argument übergeben.
Siehe auch addFormWindow() und setActiveFormWindow().
[pure virtual] int QDesignerFormWindowManagerInterface::formWindowCount() const
Gibt die Anzahl der Formularfenster zurück, die vom Formularfenster-Manager von Qt Widgets Designer verwaltet werden.
[signal] void QDesignerFormWindowManagerInterface::formWindowRemoved(QDesignerFormWindowInterface *formWindow)
Dieses Signal wird ausgegeben, wenn ein Formularfenster aus der Sammlung von Fenstern entfernt wird, die der Formularfenster-Manager von Qt Widgets Designer verwaltet. Ein Zeiger auf das entfernte formWindow wird als Argument übergeben.
Siehe auch removeFormWindow().
[signal] void QDesignerFormWindowManagerInterface::formWindowSettingsChanged(QDesignerFormWindowInterface *formWindow)
Dieses Signal wird ausgesendet, wenn sich die Einstellungen des Formularfensters ändern. Es kann verwendet werden, um Fenstertitel usw. entsprechend zu aktualisieren. Als Argument wird ein Zeiger auf die formWindow übergeben.
Siehe auch FormWindowSettingsDialogAction.
[pure virtual slot] void QDesignerFormWindowManagerInterface::removeFormWindow(QDesignerFormWindowInterface *formWindow)
Entfernt das angegebene formWindow aus der Sammlung von Fenstern, die der Formularfenster-Manager von Qt Widgets Designer verwaltet.
Siehe auch formWindow() und formWindowRemoved().
[pure virtual slot] void QDesignerFormWindowManagerInterface::setActiveFormWindow(QDesignerFormWindowInterface *formWindow)
Legt das angegebene formWindow als das derzeit aktive Formularfenster im Arbeitsbereich von Qt Widgets Designer fest.
Siehe auch activeFormWindow() und activeFormWindowChanged().
[pure virtual slot] void QDesignerFormWindowManagerInterface::showPluginDialog()
Öffnet einen Dialog, der die von Qt Widgets Designer geladenen Plugins und deren Ladefehler anzeigt.
[pure virtual slot] void QDesignerFormWindowManagerInterface::showPreview()
Zeigt eine Vorschau des aktuellen Formulars unter Verwendung der Standardparameter.
Siehe auch closeAllPreviews().
© 2025 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.
