En esta página

QDesignerWidgetBoxInterface Class

La clase `QDesignerWidgetBoxInterface` te permite controlar el contenido del cuadro de widgets de Qt Widgets Designer. Más información...

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

Funciones públicas

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

Descripción detallada

QDesignerWidgetBoxInterface contiene un conjunto de funciones que se utilizan habitualmente para manipular el contenido del cuadro de widgets de Qt Widgets Designer.

Qt Widgets Designer fileName utiliza un archivo XML para rellenar su cuadro de widgets. El nombre de ese archivo es una de las propiedades del cuadro de widgets, y se puede obtener mediante la función ().

QDesignerWidgetBoxInterface también proporciona la función save(), que guarda el contenido del cuadro de widgets en el archivo especificado por la propiedad «nombre de archivo» del cuadro de widgets. Si ha realizado cambios en el cuadro de widgets —por ejemplo, al soltar un widget en él— sin llamar a la función ` save()`, el contenido original se puede restaurar simplemente invocando la función ` load()`:

        auto *widgetBox = formEditor->widgetBox();

        widgetBox->load();

Qt Widgets La clase `QDesignerWidgetBoxInterface` no está pensada para ser instanciada directamente. Puede obtener una interfaz al cuadro de widgets de Qt Designer utilizando la función QDesignerFormEditorInterface::widgetBox(). El parámetro de la función QDesignerCustomWidgetInterface::initialize() proporciona un puntero al objeto QDesignerFormEditorInterface actual de Designer (formEditor en el ejemplo anterior). Al implementar un complemento de widget personalizado, debe crear una subclase de QDesignerCustomWidgetInterface para que su complemento sea visible para Qt Widgets Designer.

Si desea guardar los cambios y, al mismo tiempo, conservar el contenido original, puede utilizar la función save() combinada con la función setFileName() para guardar los cambios en otro archivo. Recuerde almacenar primero el nombre del archivo original:

        QString originalFile = widgetBox->fileName();

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

A continuación, puedes restaurar el contenido original del cuadro del widget restableciendo el nombre del archivo al original y llamando a load():

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

De forma similar, más adelante podrás utilizar tu archivo XML personalizado:

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

Véase también QDesignerFormEditorInterface.

Documentación de las funciones de miembro

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

Crea una interfaz de cuadro de widget con el parent proporcionado y la ventana flags especificada.

[override virtual noexcept] QDesignerWidgetBoxInterface::~QDesignerWidgetBoxInterface()

Elimina la interfaz de la caja de widgets.

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

Devuelve el nombre del archivo XML que Qt Widgets Designer está utilizando actualmente para rellenar su cuadro de widgets.

Véase también setFileName().

[pure virtual] bool QDesignerWidgetBoxInterface::load()

Rellena el cuadro de widgets de Qt Widgets Designer cargando (o recargando) el archivo XML especificado actualmente. Devuelve «true» si el archivo se carga correctamente; en caso contrario, devuelve «false».

Véase también setFileName().

[pure virtual] bool QDesignerWidgetBoxInterface::save()

Guarda el contenido del cuadro de widgets de Qt Widgets Designer en el archivo especificado por la función fileName(). Devuelve «true» si el contenido se guarda correctamente; en caso contrario, devuelve «false».

Véase también fileName() y setFileName().

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

Establece el archivo XML que utilizará Qt Widgets Designer para rellenar su cuadro de widgets en fileName. Debes llamar a load() para actualizar el cuadro de widgets con el nuevo archivo XML.

Véase también fileName() y load().

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