QUiLoader Class

MyWidget::MyWidget(QWidget*parent)
    : QWidget(parent)
{
    QFile file(":/forms/myform.ui");
    if(!file.open(QFile::ReadOnly))
        qFatal("Cannot open resource file");

    QUiLoader loader;
    QWidget*myWidget =loader.load(&file, this);

    QVBoxLayout*layout = newQVBoxLayout;
    layout->addWidget(myWidget);
    setLayout(layout);
}

QWidget*loadCustomWidget(constQString&className,QWidget*parent)
{
    QUiLoader loader;
    QStringList availableWidgets=loader.availableWidgets();

    if(!availableWidgets.contains(className)) {
        qWarning() << "Cannot create widget" << className;
       returnnullptr;
    }

    returnloader.createWidget(className,parent);
}

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

[explicit] QUiLoader::QUiLoader(QObject *parent = nullptr)

指定されたparent を使用して、フォームローダーを作成します。

[override virtual noexcept] QUiLoader::~QUiLoader()

ローダーを破壊する。

void QUiLoader::addPluginPath(const QString &path)

指定されたpath を、ローダーがプラグインを検索する際のパス一覧に追加します。

関連項目： pluginPaths() およびclearPluginPaths()。

QStringList QUiLoader::availableLayouts() const

createLayout() 関数を使用して構築可能な、利用可能なすべてのレイアウトのリストを返します。

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

QStringList QUiLoader::availableWidgets() const

createWidget() 関数を使用して構築可能な、利用可能なすべてのウィジェットのリストを返します。つまり、指定されたプラグインパス内に定義されているすべてのウィジェットです。

pluginPaths() およびcreateWidget()も参照してください 。

void QUiLoader::clearPluginPaths()

プラグインを検索する際にローダーが検索するパス一覧をクリアします。

addPluginPath() およびpluginPaths()も参照してください 。

[virtual] QAction *QUiLoader::createAction(QObject *parent = nullptr, const QString &name = QString())

指定されたparent およびname を使用して、新しいアクションを作成します。

この関数は、QUiLoader クラスがアクションを作成する際にも内部で使用されます。したがって、QUiLoader をサブクラス化し、この関数を再実装することで、ユーザーインターフェースやウィジェットの構築プロセスに介入することができます。ただし、実装の際には、必ず最初にQUiLoader のバージョンを呼び出すようにしてください。

createActionGroup()、createWidget()、およびload()も参照してください 。

[virtual] QActionGroup *QUiLoader::createActionGroup(QObject *parent = nullptr, const QString &name = QString())

指定されたparent およびname を使用して、新しいアクショングループを作成します。

この関数は、QUiLoader クラスがアクショングループを作成する際にも内部で使用されます。したがって、QUiLoader をサブクラス化し、この関数を再実装することで、ユーザーインターフェースやウィジェットの構築プロセスに介入することができます。ただし、実装の際は、必ず最初にQUiLoader のバージョンを呼び出すようにしてください。

createAction()、createWidget()、およびload()も参照してください 。

[virtual] QLayout *QUiLoader::createLayout(const QString &className, QObject *parent = nullptr, const QString &name = QString())

className で指定されたクラスを使用して、指定されたparent およびname を持つ新しいレイアウトを作成します。

この関数は、QUiLoader クラスがレイアウトを作成する際にも内部で使用されます。したがって、QUiLoader をサブクラス化し、この関数を再実装することで、ユーザーインターフェースやウィジェットの構築プロセスに介入することができます。ただし、実装する際は、必ず最初にQUiLoader のバージョンを呼び出すようにしてください。

createWidget() およびload()も参照してください 。

[virtual] QWidget *QUiLoader::createWidget(const QString &className, QWidget *parent = nullptr, const QString &name = QString())

className で指定されたクラスを使用し、指定されたparent およびname を持つ新しいウィジェットを作成します。この関数を使用すると、availableWidgets()関数が返す任意のウィジェットを作成できます。

また、この関数は、QUiLoader クラスがウィジェットを作成する際に内部的に使用されます。したがって、QUiLoader をサブクラス化し、この関数を再実装することで、ユーザーインターフェースやウィジェットの構築プロセスに介入することができます。ただし、実装の際には、必ず最初にQUiLoader のバージョンを呼び出すようにしてください。

availableWidgets() およびload()も参照してください 。

QString QUiLoader::errorString() const

load() で発生した直近のエラーについて、人間が理解しやすい説明を返します。

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

bool QUiLoader::isLanguageChangeEnabled() const

言語変更時の動的再翻訳が有効になっている場合は `true ` を返し、そうでない場合は `false ` を返します。

デフォルトはfalse です。

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

QWidget *QUiLoader::load(QIODevice *device, QWidget *parentWidget = nullptr)

指定されたdevice からフォームをインスタンス化します。成功した場合は、指定されたparentWidget を持つ新しいQWidget を返します。それ以外の場合は、nullptr を返します。

createWidget() およびerrorString()も参照してください 。

QStringList QUiLoader::pluginPaths() const

カスタムウィジェットプラグインを検索する際に、ローダーが検索対象とするパスを列挙したリストを返します。

addPluginPath() およびclearPluginPaths()も参照してください 。

void QUiLoader::setLanguageChangeEnabled(bool enabled)

enabled が true の場合、このローダーによって読み込まれたユーザーインターフェースは、言語変更イベントを受信すると自動的に再翻訳されます。そうでない場合、ユーザーインターフェースは再翻訳されません。

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

void QUiLoader::setWorkingDirectory(const QDir &dir)

ローダーの作業ディレクトリを `dir` に設定します。ローダーは、このディレクトリを基準とした相対パスで、アイコンやリソースファイルなどの他のリソースを検索します。

関連項目：workingDirectory()も参照してください 。

QDir QUiLoader::workingDirectory() const

ローダーの作業ディレクトリを返します。

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