Класс 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 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().