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();

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

Member Function Documentation

QAbstractFormBuilder::QAbstractFormBuilder()

Constructs a new form builder.

[virtual] QAbstractFormBuilder::~QAbstractFormBuilder()

Destroys the form builder.

QString QAbstractFormBuilder::errorString() const

Returns a human-readable description of the last error occurred in load().

This function was introduced in Qt 5.0.

See also load().

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

Loads an XML representation of a widget from the given device, and constructs a new widget with the specified parent.

See also save() and errorString().

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

Saves an XML representation of the given widget to the specified device in the standard UI file format.

Note: Unlike when saving a form in Qt Designer, all property values are written. This is because, the state of whether a property value was modified or not isn't stored in the Qt property system. The widget that is being saved, could have been created dynamically, not loaded via load(), so in this case the form builder isn't aware of the list of changed properties. Also, there's no generic way to do this for widgets that were created dynamically.

Therefore, you should remove properties that are not required from your resulting XML files, before loading them. Alternatively, if you already know which properties you want to save when you call this method, you can overload computeProperties() and return a filtered list of required properties. Otherwise, unexpected behavior may occur as some of these properties may depend on each other.

See also load().

void QAbstractFormBuilder::setWorkingDirectory(const QDir &directory)

Sets the current working directory of the form builder to the specified directory.

See also workingDirectory().

QDir QAbstractFormBuilder::workingDirectory() const

Returns the current working directory of the form builder.

See also setWorkingDirectory().