QFormBuilder Class

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

Header: #include <QFormBuilder>
CMake: find_package(Qt6 REQUIRED COMPONENTS Designer)
target_link_libraries(mytarget PRIVATE Qt6::Designer)
qmake: QT += designer
Inherits: 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 で指定したリストに設定します。

addPluginPath()も参照して ください。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。