QQmlIncubator Class

詳細な説明

ビューのデリゲートやアプリケーションの新規ページのような QML オブジェクトの生成には、特にリソースに制約のあるモバイルデバイスでは、顕著な時間がかかることがあります。アプリケーションがQQmlComponent::create() を直接使用する場合、QML オブジェクトのインスタンスは同期的に生成されます。

QQmlIncubatorを使用することで、QMLオブジェクトの生成をより細かく制御することができます。次の例では、QQmlIncubatorの簡単な使い方を示します。

// Initialize the incubator
QQmlIncubator incubator;
component->create(incubator);

インキュベータをしばらく実行させ(通常はイベントループに制御を戻します)、 その後ポーリングします。後でインキュベーターに戻る方法はいくつかあります。QQuickWindow から送られるシグナルのひとつに接続したいかもしれないし、そのために特別にQTimer を実行したいかもしれない。また、特定の目的のためにオブジェクトを必要とし、その目的が発生したときにインキュベーターをポーリングすることもできます。

// Poll the incubator
if (incubator.isReady()) {
    QObject *object = incubator.object();
    // Use created object
}

非同期インキュベータは、QQmlEngine に設定されるQQmlIncubationController によって制御されます。 は、アプリケーションがアイドルで、インキュベート・オブジェクトを処理すべきタイミングをエンジンに知らせます。インキュベーション・コントローラーがQQmlEngine に設定されていない場合、QQmlIncubator は指定されたIncubationMode に関係なく同期的にオブジェクトを作成します。デフォルトでは、インキュベーション・コントローラは設定されていない。しかし、QQuickView 、QQuickWindow 、QQuickWidget はすべて、それぞれのQQmlEngineにインキュベーションコントローラを設定します。これらのインキュベーションコントローラは、ビューのレンダリング中に、複数のフレームにまたがってインキュベーションを行います。

QQmlIncubatorは3つのインキュベーションモードをサポートしています：

• 同期（Synchronous） 作成は同期的に行われます。つまり、QQmlComponent::create() 呼び出しが返されると、インキュベーターは既に Error または Ready 状態になります。同期インキュベータは、QQmlComponent の同期作成メソッドを直接使用する場合と比較して、実質的な利点はありませんが、同期作成と非同期作成の両方に同じAPIを使用することで、アプリケーションの実装を簡素化できる可能性があります。
• 非同期 (デフォルト)QQmlEngine に QQmlIncubatorController が設定されている場合、作成は非同期で行われます。

  インキュベータは、作成が完了するかエラーが発生するまで Loading 状態のままになります。statusChanged() コールバックを使用して、ステータスの変更を通知できます。

  アプリケーションは、すぐに必要としないオブジェクトを作成するために、非同期インキュベーション・モードを使用する必要があります。例えば、ListView 型は非同期インキュベーションを使用して、リストがスクロールされている間、画面から少し外れたオブジェクトを作成する。非同期作成中にオブジェクトがすぐに必要になった場合は、QQmlIncubator::forceCompletion （）メソッドを呼び出して同期的に作成処理を完了させることができる。

• AsynchronousIfNested ネストされた非同期作成の一部であれば非同期で、そうでなければ同期で作成が行われます。

  QML コンポーネントが同期的なインスタンス生成のように見せかけたい場合、ほとんどのシナリオではこのモードを使うべきです。

  このモードについて、例を挙げて説明します。ListView タイプが最初に作成されたとき、表示するデリゲートの初期セットを自分自身に入力する必要があります。ListView の高さが400ピクセルで、各デリゲートの高さが100ピクセルの場合、4つの初期デリゲート・インスタンスを作成する必要があります。もしListView が非同期インキュベーション・モードを使用した場合、ListView は常に空の状態で作成され、しばらくして4つの初期アイテムが表示される。

  逆に、ListView が同期インキュベーションモードを使用した場合、正しく動作しますが、アプリケーションにスタッタが発生する可能性があります。QMLはListView のデリゲートを同期的に停止してインスタンス化する必要があるため、ListView が非同期にインスタンス化されるQMLコンポーネントの一部であった場合、非同期インスタンス化の利点の多くが失われることになります。

  AsynchronousIfNested 。AsynchronousIfNested を使用することで、ListView 自身がすでに非同期インスタンス化の一部である場合はListView のデリゲートが非同期にインスタンス化され、そうでない場合は同期的にインスタンス化されます。入れ子になった非同期インスタンス化の場合、外側の非同期インスタンス化は、 すべての入れ子のインスタンス化が完了するまで完了しない。これにより、外側の非同期インスタンス化が完了するまでに、ListView のような内側のアイテムはすでに初期デリゲートのロードを完了していることが保証されます。

  同期インスタンス化のように見せたいが、アプリケーションにフリーズやスタッタを発生させるデメリットがない要素やコンポーネントは、AsynchronousIfNested インキュベーションモードを使用する必要があります。