En esta página

QAbstractFormBuilder Class

La clase `QAbstractFormBuilder` proporciona una implementación por defecto para las clases que crean interfaces de usuario en tiempo de ejecución. Más información...

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

QFormBuilder

Funciones públicas

QAbstractFormBuilder()
QAbstractFormBuilder(const QAbstractFormBuilder &)
QAbstractFormBuilder(QAbstractFormBuilder &&)
virtual ~QAbstractFormBuilder()
QString errorString() const
virtual QWidget *load(QIODevice *device, QWidget *parent = nullptr)
virtual void save(QIODevice *device, QWidget *widget)
void setWorkingDirectory(const QDir &directory)
QDir workingDirectory() const
QAbstractFormBuilder &operator=(QAbstractFormBuilder &&)
QAbstractFormBuilder &operator=(const QAbstractFormBuilder &)

Descripción detallada

QAbstractFormBuilder proporciona una interfaz estándar y una implementación por defecto para construir formularios a partir de archivos de interfaz de usuario. No está pensado para ser instanciado directamente. Utiliza la clase QFormBuilder para crear interfaces de usuario a partir de archivos de interfaz de usuario en tiempo de ejecución. Por ejemplo:

        MyForm::MyForm(QWidget *parent)
            : QWidget(parent)
        {
            QFormBuilder builder;
            QFile file(":/forms/myWidget.ui");
            file.open(QFile::ReadOnly);
            QWidget *myWidget = builder.load(&file, this);
            file.close();

            auto *layout = new QVBoxLayout(this);
            layout->addWidget(myWidget);
        }

Para anular determinados aspectos del comportamiento del generador de formularios, cree una subclase de QAbstractFormBuilder y reimplemente las funciones virtuales pertinentes:

  • load() se encarga de leer archivos en formato UI desde dispositivos QIODevices arbitrarios y de construir widgets a partir de los datos XML que contienen.
  • save() se encarga de guardar los detalles de los widgets en formato UI en dispositivos QIODevices arbitrarios.
  • workingDirectory() y setWorkingDirectory() controlan el directorio en el que se almacenan los formularios. El generador de formularios busca otros recursos en rutas relativas a este directorio.

La clase ` QFormBuilder ` suele ser utilizada por componentes personalizados y aplicaciones que incorporan ` Qt Widgets Designer`. Las aplicaciones independientes que necesitan generar dinámicamente interfaces de usuario en tiempo de ejecución utilizan ` QUiLoader`, que se encuentra en el Qt UI Tools .

Véase también Qt UI Tools.

Documentación de las funciones de miembro

QAbstractFormBuilder::QAbstractFormBuilder()

Crea un nuevo generador de formularios.

[delete] QAbstractFormBuilder::QAbstractFormBuilder(const QAbstractFormBuilder &)

Crea una instancia de « QAbstractFormBuilder » mediante copia. Esta función se ha eliminado.

[delete] QAbstractFormBuilder::QAbstractFormBuilder(QAbstractFormBuilder &&)

Crea una instancia de ` QAbstractFormBuilder`. Esta función se ha eliminado.

[virtual noexcept] QAbstractFormBuilder::~QAbstractFormBuilder()

Elimina el generador de formularios.

QString QAbstractFormBuilder::errorString() const

Devuelve una descripción comprensible para el usuario del último error que se ha producido en load().

Véase también load().

[virtual] QWidget *QAbstractFormBuilder::load(QIODevice *device, QWidget *parent = nullptr)

Carga una representación XML de un widget a partir de la dirección device indicada y crea un nuevo widget con la dirección parent especificada.

Véase también save() y errorString().

[virtual] void QAbstractFormBuilder::save(QIODevice *device, QWidget *widget)

Guarda una representación XML del archivo « widget » en la ruta especificada « device » en el formato de archivo estándar de la interfaz de usuario.

Nota: A diferencia de lo que ocurre al guardar un formulario en Qt Widgets Designer, se escriben todos los valores de las propiedades. Esto se debe a que el estado de si un valor de propiedad se ha modificado o no no se almacena en el sistema de propiedades de Qt. El widget que se está guardando podría haberse creado dinámicamente, en lugar de cargarse mediante load(), por lo que, en este caso, el generador de formularios no tiene constancia de la lista de propiedades modificadas. Además, no existe una forma genérica de hacerlo para los widgets creados dinámicamente.

Por lo tanto, debes eliminar las propiedades que no sean necesarias de los archivos XML resultantes antes de cargarlos. Como alternativa, si ya sabes qué propiedades quieres guardar al llamar a este método, puedes sobrecargar ` computeProperties() ` y devolver una lista filtrada de las propiedades necesarias. De lo contrario, pueden producirse comportamientos inesperados, ya que algunas de estas propiedades pueden depender unas de otras.

Véase también ` load()`.

void QAbstractFormBuilder::setWorkingDirectory(const QDir &directory)

Establece el directorio de trabajo actual del generador de formularios en la ruta especificada directory.

Véase también workingDirectory().

QDir QAbstractFormBuilder::workingDirectory() const

Devuelve el directorio de trabajo actual del generador de formularios.

Véase también setWorkingDirectory().

[delete] QAbstractFormBuilder &QAbstractFormBuilder::operator=(QAbstractFormBuilder &&)

Asigna mediante «move» « other » a esta instancia de « QAbstractFormBuilder ». Esta función se elimina.

[delete] QAbstractFormBuilder &QAbstractFormBuilder::operator=(const QAbstractFormBuilder &)

Asigna por copia other a esta instancia de QAbstractFormBuilder. Esta función se ha eliminado.

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