QDesignerWidgetBoxInterface Class

Die Klasse QDesignerWidgetBoxInterface ermöglicht es Ihnen, den Inhalt der Widgetbox von Qt Widgets Designer zu kontrollieren. Mehr...

Kopfzeile: #include <QDesignerWidgetBoxInterface>
CMake: find_package(Qt6 REQUIRED COMPONENTS Designer)
target_link_libraries(mytarget PRIVATE Qt6::Designer)
qmake: QT += designer
Vererbungen: QWidget

Öffentliche Funktionen

QDesignerWidgetBoxInterface(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
virtual ~QDesignerWidgetBoxInterface()
virtual QString fileName() const = 0
virtual bool load() = 0
virtual bool save() = 0
virtual void setFileName(const QString &fileName) = 0

Detaillierte Beschreibung

QDesignerWidgetBoxInterface enthält eine Sammlung von Funktionen, die typischerweise verwendet werden, um den Inhalt der Widgetbox von Qt Widgets Designer zu manipulieren.

Qt Widgets Der Designer verwendet eine XML-Datei, um seine Widgetbox zu füllen. Der Name dieser Datei ist eine der Eigenschaften der Widgetbox, und Sie können ihn mit der Funktion fileName() abrufen.

QDesignerWidgetBoxInterface bietet auch die Funktion save(), die den Inhalt der Widgetbox in der Datei speichert, die durch die Eigenschaft Dateiname der Widgetbox angegeben ist. Wenn Sie Änderungen an der Widgetbox vorgenommen haben, z.B. indem Sie ein Widget in die Widgetbox fallen ließen, ohne die Funktion save() aufzurufen, kann der ursprüngliche Inhalt durch einen einfachen Aufruf der Funktion load() wiederhergestellt werden:

        auto *widgetBox = formEditor->widgetBox();

        widgetBox->load();

Die Klasse QDesignerWidgetBoxInterface ist nicht dazu gedacht, direkt instanziert zu werden. Sie können eine Schnittstelle zur Widgetbox von Qt Designer mit der Funktion QDesignerFormEditorInterface::widgetBox() abrufen. Ein Zeiger auf Qt Widgets Designer's aktuelles QDesignerFormEditorInterface Objekt (formEditor im obigen Beispiel) wird durch den Parameter der Funktion QDesignerCustomWidgetInterface::initialize() bereitgestellt. Wenn Sie ein benutzerdefiniertes Widget-Plugin implementieren, müssen Sie die Unterklasse QDesignerCustomWidgetInterface verwenden, um Ihr Plugin dem Qt Widgets Designer zur Verfügung zu stellen.

Wenn Sie Ihre Änderungen speichern und gleichzeitig den ursprünglichen Inhalt beibehalten möchten, können Sie die Funktion save() in Kombination mit der Funktion setFileName() verwenden, um Ihre Änderungen in einer anderen Datei zu speichern. Denken Sie daran, zuerst den Namen der Originaldatei zu speichern:

        QString originalFile = widgetBox->fileName();

        widgetBox->setFileName("myWidgetBox.xml");
        widgetBox->save();

Dann können Sie den ursprünglichen Inhalt der Widgetbox wiederherstellen, indem Sie den Dateinamen auf die Originaldatei zurücksetzen und load() aufrufen:

        widgetBox->setFileName(originalFile);
        widgetBox->load();

Auf ähnliche Weise können Sie später Ihre angepasste XML-Datei verwenden:

        if (widgetBox->filename() != "myWidgetBox.xml") {
            widgetBox->setFileName("myWidgetBox.xml");
            widgetBox->load();
        }

Siehe auch QDesignerFormEditorInterface.

Dokumentation der Mitgliedsfunktionen

[explicit] QDesignerWidgetBoxInterface::QDesignerWidgetBoxInterface(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Konstruiert eine Widgetbox-Schnittstelle mit der angegebenen parent und dem angegebenen Fenster flags.

[virtual noexcept] QDesignerWidgetBoxInterface::~QDesignerWidgetBoxInterface()

Zerstört die Schnittstelle der Widgetbox.

[pure virtual] QString QDesignerWidgetBoxInterface::fileName() const

Gibt den Namen der XML-Datei zurück, die Qt Widgets Designer derzeit verwendet, um seine Widgetbox zu füllen.

Siehe auch setFileName().

[pure virtual] bool QDesignerWidgetBoxInterface::load()

Befüllt das Widgetfeld von Qt Widgets Designer durch Laden (oder erneutes Laden) der aktuell angegebenen XML-Datei. Gibt true zurück, wenn die Datei erfolgreich geladen wurde; andernfalls false.

Siehe auch setFileName().

[pure virtual] bool QDesignerWidgetBoxInterface::save()

Speichert den Inhalt der Widgetbox von Qt Widgets Designer in der von der Funktion fileName() angegebenen Datei. Gibt true zurück, wenn der Inhalt erfolgreich gespeichert wurde; andernfalls false.

Siehe auch fileName() und setFileName().

[pure virtual] void QDesignerWidgetBoxInterface::setFileName(const QString &fileName)

Setzt die XML-Datei, die Qt Widgets Designer verwendet, um seine Widget-Box zu füllen, auf fileName. Sie müssen load() aufrufen, um die Widget-Box mit der neuen XML-Datei zu aktualisieren.

Siehe auch fileName() und load().

© 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.