QQmlApplicationEngine Class

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

QQmlApplicationEngine::QQmlApplicationEngine(QObject *parent = nullptr)

与えられたparent で新しい QQmlApplicationEngine を作成します。QML ファイルを読み込むには、後でload() を呼び出す必要があります。

QQmlApplicationEngine::QQmlApplicationEngine(const QString &filePath, QObject *parent = nullptr)

新しい QQmlApplicationEngine を作成し、与えられたfilePath にある QML ファイルをロードします。 はローカルファイルまたは qrc パスでなければなりません。相対パスが指定された場合は、アプリケーションの作業ディレクトリからの相対パスとして解釈されます。

これは便宜的なものであり、空のコンストラクタを使用し、その後に load を呼び出すのと同じです。

QQmlApplicationEngine::QQmlApplicationEngine(const QUrl &url, QObject *parent = nullptr)

新しい QQmlApplicationEngine を作成し、与えられたurl にある QML ファイルをロードします。これは便宜上提供されているもので、空のコンストラクタを使用し、その後にloadを呼び出すのと同じです。

[explicit, since 6.5] QQmlApplicationEngine::QQmlApplicationEngine(QAnyStringView uri, QAnyStringView typeName, QObject *parent = nullptr)

新しい QQmlApplicationEngine を作成し、uri とtypeName で指定された QML タイプをロードします。これは便宜上提供されているもので、空のコンストラクタを使用し、その後にloadFromModule を呼び出すのと同じです。

この関数は Qt 6.5 で導入されました。

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

QQmlApplicationEngine とそれが読み込んだすべての QML オブジェクトを破棄します。

[slot] void QQmlApplicationEngine::load(const QString &filePath)

filePath にあるルート QML ファイルを読み込みます。filePath はローカルファイルへのパスか、リソースファイルシステム内のファイルへのパスでなければなりません。filePath が相対パスの場合、アプリケーションの作業ディレクトリからの相対パスとみなされます。ファイルによって定義されたオブジェクト・ツリーは直ちにインスタンス化される。

エラーが発生した場合、エラーメッセージはqWarning で表示されます。

[slot] void QQmlApplicationEngine::load(const QUrl &url)

url にあるルート QML ファイルを読み込みます。ファイルによって定義されたオブジェクトツリーは、ローカルファイルの URL に対して直ちに作成されます。リモートのURLは非同期にロードされます。オブジェクトツリーの準備ができたかどうかはobjectCreated シグナルを聞いて判断してください。

エラーが発生した場合、NULLポインタをパラメータとしてobjectCreated シグナルが発行され、エラーメッセージはqWarning で表示されます。

[slot] void QQmlApplicationEngine::loadData(const QByteArray &data, const QUrl &url = QUrl())

data で指定されたQMLをロードします。data で定義されたオブジェクトツリーは直ちにインスタンス化されます。

url が指定された場合、それがコンポーネントのベースURLとして使用されます。これはデータやエラーメッセージの相対パスに影響します。

エラーが発生した場合、エラーメッセージはqWarning で表示されます。

[slot, since 6.5] void QQmlApplicationEngine::loadFromModule(QAnyStringView uri, QAnyStringView typeName)

uri で指定されたモジュールから QML の型typeName を読み込みます。型がリモートのURLにあるQMLファイルに由来する場合、型は非同期にロードされます。オブジェクトツリーの準備ができたらobjectCreated シグナルを聞いてください。

エラーが発生した場合、objectCreated シグナルがNULLポインタをパラメータとして発せられ、エラーメッセージはqWarning で表示されます。

QQmlApplicationEngine engine;
engine.loadFromModule("QtQuick", "Rectangle");

この関数は Qt 6.5 で導入されました。

QQmlComponent::loadFromModuleも参照してください 。

[signal] void QQmlApplicationEngine::objectCreated(QObject *object, const QUrl &url)

このシグナルはオブジェクトのロードが終了したときに発せられます。ロードが成功した場合、object はロードされたオブジェクトへのポインタを含み、そうでない場合、ポインタはNULLです。

object の元となったコンポーネントへのurl も提供される。

[signal, since 6.4] void QQmlApplicationEngine::objectCreationFailed(const QUrl &url)

このシグナルは、エラーが発生して読み込みが終了したときに発行されます。

ロードに失敗したコンポーネントへのurl が引数として提供される。

QGuiApplication app(argc, argv);
QQmlApplicationEngine engine;

// exit on error
QObject::connect(&engine, &QQmlApplicationEngine::objectCreationFailed,
    &app, []() { QCoreApplication::exit(-1); }, Qt::QueuedConnection);
engine.load(QUrl());
return app.exec();

QQmlApplicationEngine::objectCreated も参照してください。（作成に失敗しても）このシグナルに加えて発行されます。

この関数は Qt 6.4 で導入されました。

QList<QObject *> QQmlApplicationEngine::rootObjects() const

QQmlApplicationEngine によってインスタンス化されたすべてのルートオブジェクトのリストを返します。 これには、load() またはコンビニエンスコンストラクタによってロードされたオブジェクトのみが含まれます。

[slot, since 6.0] void QQmlApplicationEngine::setExtraFileSelectors(const QStringList &extraFileSelectors)

ローカルファイルへの URL の解決に使用される内部QQmlFileSelector に渡されるextraFileSelectors を設定します。extraFileSelectors は最初の QML ファイルがロードされたときに適用されます。それ以降に設定しても効果はありません。

この関数は Qt 6.0 で導入されました。

QQmlFileSelector とQFileSelector::setExtraSelectorsも参照してください 。

[slot] void QQmlApplicationEngine::setInitialProperties(const QVariantMap &initialProperties)

QML コンポーネントがロードされた後に初期化されるinitialProperties を設定します。

QQmlApplicationEngine engine;

EventDatabase eventDatabase;
EventMonitor eventMonitor;

engine.setInitialProperties({
    { "eventDatabase", QVariant::fromValue(&eventDatabase) },
    { "eventMonitor", QVariant::fromValue(&eventMonitor) }
});

QQmlComponent::setInitialProperties 、QQmlApplicationEngine::load 、QQmlApplicationEngine::loadDataも参照して ください。