QUiLoader Class

MyWidget::MyWidget(QWidget *parent)
    : QWidget(parent)
{
    QUiLoader loader;
    QFile file(":/forms/myform.ui");
    file.open(QFile::ReadOnly);
    QWidget *myWidget = loader.load(&file, this);
    file.close();

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

<!DOCTYPE RCC><RCC version="1.0">
<qresource prefix="/forms">
<file>myform.ui</file>
</qresource>
</RCC>

QWidget *loadCustomWidget(QWidget *parent)
{
    QUiLoader loader;
    QWidget *myWidget;

    QStringList availableWidgets = loader.availableWidgets();

    if (availableWidgets.contains("AnalogClock"))
        myWidget = loader.createWidget("AnalogClock", parent);

    return myWidget;
}

メンバ関数ドキュメント

[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 を返します。

setLanguageChangeEnabled()も参照 ください。

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

与えられたdevice からフォームを読み込み、その内容を保持するために、与えられたparentWidget で新しいウィジェットを作成します。

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()も参照 。