QQmlIncubator Class

Detaillierte Beschreibung

Das Erstellen von QML-Objekten - wie z.B. Delegates in einer Ansicht oder eine neue Seite in einer Anwendung - kann sehr viel Zeit in Anspruch nehmen, insbesondere auf ressourcenbeschränkten mobilen Geräten. Wenn eine Anwendung QQmlComponent::create() direkt verwendet, wird die QML-Objektinstanz synchron erstellt, was, je nach Komplexität des Objekts, zu merklichen Pausen oder Stottern in der Anwendung führen kann.

Die Verwendung von QQmlIncubator bietet mehr Kontrolle über die Erstellung eines QML-Objekts, einschließlich der Möglichkeit, es asynchron unter Verwendung der Leerlaufzeit der Anwendung zu erstellen. Das folgende Beispiel zeigt eine einfache Verwendung von QQmlIncubator.

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

Lassen Sie den Inkubator eine Zeit lang laufen (normalerweise durch Rückgabe der Kontrolle an die Ereignisschleife) und rufen Sie ihn dann ab. Es gibt eine Reihe von Möglichkeiten, später wieder auf den Inkubator zuzugreifen. Vielleicht möchten Sie eine Verbindung zu einem der Signale herstellen, die von QQuickWindow gesendet werden, oder Sie möchten speziell dafür eine QTimer ausführen. Sie können das Objekt auch für einen bestimmten Zweck benötigen und den Inkubator abfragen, wenn sich dieser Zweck ergibt.

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

Asynchrone Inkubatoren werden von einer QQmlIncubationController gesteuert, die auf der QQmlEngine eingestellt ist und die der Engine mitteilt, wann die Anwendung im Leerlauf ist und inkubierende Objekte verarbeitet werden sollen. Wenn auf der QQmlEngine kein Inkubationscontroller eingestellt ist, erstellt QQmlIncubator Objekte synchron, unabhängig vom angegebenen IncubationMode. Standardmäßig ist kein Inkubationscontroller eingestellt. QQuickView , QQuickWindow und QQuickWidget setzen jedoch alle Inkubations-Controller auf ihren jeweiligen QQmlEngines. Diese Inkubations-Controller verteilen die Inkubationen über mehrere Frames, während die Ansicht gerendert wird.

QQmlIncubator unterstützt drei Inkubationsmodi:

• Synchronous Die Erstellung erfolgt synchron. Das heißt, sobald der QQmlComponent::create()-Aufruf zurückkehrt, befindet sich der Inkubator bereits entweder im Fehler- oder im Bereitschaftsstatus. Ein synchroner Inkubator hat keinen wirklichen Vorteil gegenüber der direkten Verwendung der synchronen Erstellungsmethoden auf QQmlComponent, aber es kann die Implementierung einer Anwendung vereinfachen, wenn dieselbe API sowohl für synchrone als auch für asynchrone Erstellungen verwendet wird.
• Asynchron (Standard) Die Erstellung erfolgt asynchron, vorausgesetzt, auf QQmlEngine ist ein QQmlIncubatorController eingestellt.

  Der Inkubator bleibt im Zustand Loading, bis entweder die Erstellung abgeschlossen ist oder ein Fehler auftritt. Der Callback statusChanged() kann verwendet werden, um über Statusänderungen informiert zu werden.

  Anwendungen sollten den asynchronen Inkubationsmodus verwenden, um Objekte zu erstellen, die nicht sofort benötigt werden. Zum Beispiel verwendet der Typ ListView die asynchrone Inkubation, um Objekte zu erstellen, die sich etwas außerhalb des Bildschirms befinden, während die Liste gescrollt wird. Wenn das Objekt während der asynchronen Erstellung sofort benötigt wird, kann die Methode QQmlIncubator::forceCompletion() aufgerufen werden, um den Erstellungsprozess synchron zu beenden.

• AsynchronousIfNested Die Erstellung erfolgt asynchron, wenn sie Teil einer verschachtelten asynchronen Erstellung ist, oder synchron, wenn nicht.

  In den meisten Szenarien, in denen eine QML-Komponente den Anschein einer synchronen Instanziierung erwecken möchte, sollte sie diesen Modus verwenden.

  Dieser Modus lässt sich am besten anhand eines Beispiels erklären. Wenn der Typ ListView zum ersten Mal erstellt wird, muss er sich selbst mit einem anfänglichen Satz von anzuzeigenden Delegierten bestücken. Wenn die ListView 400 Pixel hoch ist und jeder Delegat 100 Pixel hoch ist, müssen vier anfängliche Delegateninstanzen erstellt werden. Wenn ListView den asynchronen Inkubationsmodus verwendet, wird ListView immer leer erstellt und irgendwann später werden die vier anfänglichen Elemente angezeigt.

  Würde ListView dagegen den synchronen Inkubationsmodus verwenden, würde es sich korrekt verhalten, aber es könnte zu Stottern in der Anwendung kommen. Da QML anhalten und die Delegaten von ListView synchron instanziieren müsste, würde dies einen Großteil der Vorteile der asynchronen Instanziierung zunichte machen, wenn ListView Teil einer QML-Komponente ist, die asynchron instanziiert wird.

  Der Modus AsynchronousIfNested löst dieses Problem. Durch die Verwendung von AsynchronousIfNested werden die Delegierten von ListView asynchron instanziiert, wenn ListView selbst bereits Teil einer asynchronen Instanziierung ist, und ansonsten synchron. Im Falle einer verschachtelten asynchronen Instanziierung wird die äußere asynchrone Instanziierung erst abgeschlossen, nachdem alle verschachtelten Instanziierungen ebenfalls abgeschlossen sind. Dadurch wird sichergestellt, dass zu dem Zeitpunkt, an dem die äußere asynchrone Instanziierung abgeschlossen ist, innere Elemente wie ListView bereits das Laden ihrer anfänglichen Delegierten abgeschlossen haben.

  Es ist fast immer falsch, die synchrone Instanziierung zu verwenden - Elemente oder Komponenten, die den Anschein einer synchronen Instanziierung erwecken wollen, aber ohne die Nachteile der Einführung von Freezes oder Stutters in die Anwendung, sollten den AsynchronousIfNested Inkubationsmodus verwenden.