QDesignerWidgetBoxInterface Class

Descripción Detallada

QDesignerWidgetBoxInterface contiene una colección de funciones que se utilizan normalmente para manipular el contenido de la caja de widgets de Qt Widgets Designer.

Qt Widgets Designer usa un archivo XML para rellenar su caja de widgets. El nombre de ese archivo es una de las propiedades de la caja de widgets, y puedes recuperarlo usando la función fileName().

QDesignerWidgetBoxInterface también proporciona la función save() que guarda el contenido de la caja widget en el archivo especificado por la propiedad nombre de archivo de la caja widget. Si se han realizado cambios en la caja de widgets, por ejemplo soltando un widget en la caja de widgets, sin llamar a la función save(), el contenido original puede restaurarse con una simple invocación a la función load():

        auto *widgetBox = formEditor->widgetBox();

        widgetBox->load();

La clase QDesignerWidgetBoxInterface no está pensada para ser instanciada directamente. Puede recuperar una interfaz a Qt Designer's widget box utilizando la función QDesignerFormEditorInterface::widgetBox(). El parámetro de la función QDesignerCustomWidgetInterface::initialize() proporciona un puntero al objeto QDesignerFormEditorInterface actual de Qt Widgets Designer (formEditor en el ejemplo anterior). Al implementar un plugin de widget personalizado, debe subclasificar el QDesignerCustomWidgetInterface para exponer su plugin a Qt Widgets Designer.

Si quieres guardar tus cambios, y al mismo tiempo preservar el contenido original, puedes usar la función save() combinada con la función setFileName() para guardar tus cambios en otro archivo. Recuerda guardar primero el nombre del archivo original:

        QString originalFile = widgetBox->fileName();

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

A continuación, puede restaurar el contenido original del cuadro de widgets restableciendo el nombre del archivo original y llamando a load():

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

De forma similar, puedes utilizar posteriormente tu archivo XML personalizado:

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