QFormBuilder Class

QFormBuilder クラスは、実行時に UI ファイルからユーザーインターフェースを動的に構築するために使用されます。詳細...

ヘッダー:	`#include <QFormBuilder>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS Designer)` `target_link_libraries(mytarget PRIVATE Qt6::Designer)`
qmake:	`QT += designer`
継承元:	QAbstractFormBuilder

継承されたメンバーを含むすべてのメンバーの一覧

パブリック関数

	QFormBuilder()
virtual	~QFormBuilder() override
void	addPluginPath(const QString &pluginPath)
void	clearPluginPaths()
QList<QDesignerCustomWidgetInterface *>	customWidgets() const
QStringList	pluginPaths() const
void	setPluginPath(const QStringList &pluginPaths)

詳細な説明

QFormBuilder クラスは、Qt Widgets Designer で作成された 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();

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

例のリソース（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 Widgets Designer を組み込んだカスタムコンポーネントやアプリケーションで使用されます。実行時にユーザーインターフェースを動的に生成する必要があるスタンドアロンアプリケーションでは、QtUiTools モジュールにあるQUiLoader クラスを使用します。

「 QAbstractFormBuilder 」および Qt UI Toolsを参照してください。

メンバ関数のドキュメント

QFormBuilder::QFormBuilder()

新しいフォームビルダーを作成します。

`[override virtual noexcept]` 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 で指定されたリストに設定します。