Класс QAbstractFormBuilder

Класс QAbstractFormBuilder предоставляет реализацию по умолчанию для классов, которые создают пользовательские интерфейсы во время выполнения. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Защищенные типы

Подробное описание

QAbstractFormBuilder предоставляет стандартный интерфейс и реализацию по умолчанию для построения форм из файлов пользовательского интерфейса. Не предназначен для непосредственного создания экземпляров. Используйте класс QFormBuilder для создания пользовательских интерфейсов из файлов UI во время выполнения. Например:

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

Для переопределения определенных аспектов поведения конструктора форм, наследуйте от QAbstractFormBuilder и переопределите соответствующие виртуальные функции:

• load() обрабатывает чтение файлов формата UI из произвольных QIODevice и построение виджетов из данных XML, которые они содержат.
• save() обрабатывает сохранение данных виджета в формате UI в произвольные QIODevice.
• workingDirectory() и setWorkingDirectory() управляют каталогом, в котором хранятся формы. Конструктор форм ищет другие ресурсы по путям, относительным к этому каталогу.

Класс QFormBuilder обычно используется пользовательскими компонентами и приложениями, которые встраивают Qt Designer. Самостоятельные приложения, которым необходимо динамически генерировать пользовательские интерфейсы во время выполнения, используют QUiLoader, который находится в модуле Qt UI Tools.

См. также Qt UI Tools.

Документация по функциям-членам

QAbstractFormBuilder::QAbstractFormBuilder()

Создает новый конструктор форм.

[virtual] QAbstractFormBuilder::~QAbstractFormBuilder()

Удаляет конструктор форм.

QString QAbstractFormBuilder::errorString() const

Возвращает удобочитаемое описание последней ошибки, произошедшей в load().

Эта функция была введена в Qt 5.0.

См. также load().

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

Загружает XML-представление виджета из заданного device и создает новый виджет с указанным parent.

См. также save() и errorString().

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

Сохраняет XML-представление заданного widget в указанный device в стандартном формате файла UI.

Примечание: В отличие от сохранения формы в Qt Designer, все значения свойств записываются. Это связано с тем, что состояние, было ли значение свойства изменено или нет, не сохраняется в системе свойств Qt. Виджет, который сохраняется, мог быть создан динамически, а не загружен через load(), поэтому в этом случае конструктор форм не знает список измененных свойств. Также нет универсального способа сделать это для виджетов, которые были созданы динамически.

Поэтому вам следует удалить свойства, которые не требуются, из полученных XML-файлов перед их загрузкой. В качестве альтернативы, если вы уже знаете, какие свойства вы хотите сохранить, когда вызываете этот метод, вы можете переопределить computeProperties() и вернуть отфильтрованный список требуемых свойств. В противном случае могут возникнуть непредсказуемые действия, так как некоторые из этих свойств могут зависеть друг от друга.

См. также load().

void QAbstractFormBuilder::setWorkingDirectory(const QDir &directory)

Устанавливает текущий рабочий каталог конструктора форм в указанный directory.

См. также workingDirectory().

QDir QAbstractFormBuilder::workingDirectory() const

Возвращает текущий рабочий каталог конструктора форм.

См. также setWorkingDirectory().