Класс QFormBuilder

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

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

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

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

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

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

Класс QFormBuilder предоставляет механизм для динамического создания пользовательских интерфейсов во время выполнения на основе файлов пользовательского интерфейса, созданных с помощью 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.

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

QFormBuilder::QFormBuilder()

Создает новый строитель форм.

[override 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().