Класс QFormBuilder

Класс QFormBuilder используется для динамического построения пользовательских интерфейсов из файлов UI во время выполнения. Подробнее...

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

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

• 5 открытых функций, унаследованных от QAbstractFormBuilder

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

Класс QFormBuilder используется для динамического построения пользовательских интерфейсов из файлов UI во время выполнения.

Класс QFormBuilder предоставляет механизм для динамического создания пользовательских интерфейсов во время выполнения на основе файлов UI, созданных с помощью Qt Designer. Например:

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

Включив пользовательский интерфейс в ресурсы примера (myForm.qrc), мы гарантируем, что он будет доступен при запуске примера:

    <!DOCTYPE RCC><RCC version="1.0">
    <qresource prefix="/forms">
       <file>mywidget.ui</file>
    </qresource>
    </RCC>

QFormBuilder расширяет базовый класс QAbstractFormBuilder рядом функций, используемых для поддержки плагинов пользовательских виджетов:

• pluginPaths() возвращает список путей, которые обработчик форм просматривает при загрузке плагинов пользовательских виджетов.
• addPluginPath() позволяет регистрировать дополнительные пути в обработчике форм.
• setPluginPath() используется для замены существующего списка путей списком, полученным из другого источника.
• clearPluginPaths() удаляет все зарегистрированные пути в обработчике форм.
• customWidgets() возвращает список интерфейсов плагинов, которые могут использоваться для создания новых экземпляров зарегистрированных пользовательских виджетов.

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

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

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

QFormBuilder::QFormBuilder()

Конструирует новый обработчик форм.

[virtual] QFormBuilder::~QFormBuilder()

Уничтожает обработчик форм.

void QFormBuilder::addPluginPath(const QString &pluginPath)

Добавляет новый путь к плагину, указанный в pluginPath, в список путей, которые будут просматриваться обработчиком форм при загрузке плагина пользовательского виджета.

См. также setPluginPath() и clearPluginPaths().

void QFormBuilder::clearPluginPaths()

Очищает список путей, используемых обработчиком форм для поиска плагинов пользовательских виджетов.

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

QList<QDesignerCustomWidgetInterface *> QFormBuilder::customWidgets() const

Возвращает список доступных плагинов.

QStringList QFormBuilder::pluginPaths() const

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

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

void QFormBuilder::setPluginPath(const QStringList &pluginPaths)

Устанавливает список путей к плагинам в список, указанный в pluginPaths.

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