QQmlIncubator Class

Ausführliche Beschreibung

Das Erstellen von QML-Objekten – wie z. B. Delegaten in einer Ansicht oder einer neuen Seite in einer Anwendung – kann erheblich Zeit in Anspruch nehmen, insbesondere auf mobilen Geräten mit begrenzten Ressourcen. Wenn eine Anwendung QQmlComponent::create() direkt verwendet, wird die QML-Objektinstanz synchron erstellt, was je nach Komplexität des Objekts zu spürbaren Verzögerungen oder Rucklern 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 während 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 Incubator eine Weile laufen (normalerweise, indem Sie die Kontrolle an die Ereignisschleife zurückgeben) und fragen Sie ihn dann ab. Es gibt verschiedene Möglichkeiten, später zum Incubator zurückzukehren. Sie können sich an eines der von ` QQuickWindow` gesendeten Signale anbinden oder eigens dafür einen ` QTimer ` ausführen. Möglicherweise benötigen Sie das Objekt auch für einen bestimmten Zweck und fragen den Inkubator ab, sobald dieser Zweck eintritt.

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

Asynchrone Inkubatoren werden über ein „ QQmlIncubationController “ gesteuert, das auf dem „ QQmlEngine “ festgelegt ist; dieses teilt der Engine mit, wann die Anwendung im Leerlauf ist und inkubierte Objekte verarbeitet werden sollten. Wenn kein Inkubations-Controller unter „ QQmlEngine “ festgelegt ist, erstellt „ QQmlIncubator “ Objekte synchron, unabhängig von der angegebenen „ IncubationMode “. Standardmäßig ist kein Inkubations-Controller festgelegt. Allerdings legen „ QQuickView “, „ QQuickWindow “ und „ QQuickWidget “ alle Inkubations-Controller in ihren jeweiligen „ QQmlEngines“ fest. Diese Inkubations-Controller verteilen die Inkubationen über mehrere Frames, während die Ansicht gerendert wird.

QQmlIncubator unterstützt drei Inkubationsmodi:

• Synchron: Die Erstellung erfolgt synchron. Das heißt, sobald der Aufruf von ` QQmlComponent::create()` zurückkehrt, befindet sich der Inkubator bereits im Zustand „Error“ oder „Ready“. Ein synchroner Inkubator bietet keinen wirklichen Vorteil gegenüber der direkten Verwendung der synchronen Erstellungsmethoden auf ` QQmlComponent `, kann jedoch die Implementierung einer Anwendung vereinfachen, da für synchrone und asynchrone Erstellungen dieselbe API verwendet wird.
• Asynchron (Standard) Die Erstellung erfolgt asynchron, vorausgesetzt, auf ` QQmlEngine` ist ein `QQmlIncubatorController` festgelegt.

  Der Incubator verbleibt im Status „Loading“, bis entweder die Erstellung abgeschlossen ist oder ein Fehler auftritt. Der Callback ` statusChanged()` kann verwendet werden, um über Statusänderungen benachrichtigt zu werden.

  Anwendungen sollten den asynchronen Inkubationsmodus verwenden, um Objekte zu erstellen, die nicht sofort benötigt werden. Beispielsweise nutzt der Typ ` ListView ` die asynchrone Inkubation, um Objekte zu erstellen, die sich beim Scrollen der Liste leicht außerhalb des Bildschirms befinden. Wenn das Objekt während der asynchronen Erstellung sofort benötigt wird, kann die Methode ` QQmlIncubator::forceCompletion()` aufgerufen werden, um den Erstellungsprozess synchron abzuschließen.

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

  In den meisten Szenarien, in denen eine QML-Komponente das Erscheinungsbild einer synchronen Instanziierung erzielen möchte, sollte dieser Modus verwendet werden.

  Dieser Modus lässt sich am besten anhand eines Beispiels erläutern. Wenn der Typ „ ListView “ zum ersten Mal erstellt wird, muss er sich selbst mit einem anfänglichen Satz von Delegaten füllen, um angezeigt zu werden. Wäre der „ ListView “ 400 Pixel hoch und jeder Delegate 100 Pixel hoch, müssten vier anfängliche Delegate-Instanzen erstellt werden. Würde der „ ListView “ den asynchronen Inkubationsmodus verwenden, würde der „ ListView “ immer leer erstellt und erst zu einem späteren Zeitpunkt würden die vier anfänglichen Elemente erscheinen.

  Umgekehrt würde sich die „ ListView “ bei Verwendung des synchronen Inkubationsmodus zwar korrekt verhalten, dies könnte jedoch zu Rucklern in der Anwendung führen. Da QML anhalten und die Delegaten von „ ListView “ synchron instanziieren müsste, würde dies einen Großteil des Vorteils der asynchronen Instanziierung zunichte machen, wenn „ ListView “ Teil einer QML-Komponente wäre, die asynchron instanziiert wird.

  Der Modus „ AsynchronousIfNested “ löst dieses Problem. Durch die Verwendung von ` AsynchronousIfNested` werden die Delegaten von ` ListView ` asynchron instanziiert, wenn die ` ListView ` selbst bereits Teil einer asynchronen Instanziierung ist, andernfalls 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 zum Zeitpunkt des Abschlusses der äußeren asynchronen Instanziierung die inneren Elemente wie ListView das Laden ihrer anfänglichen Delegaten bereits abgeschlossen haben.

  Die Verwendung des Inkubationsmodus „Synchronous“ ist fast immer falsch – Elemente oder Komponenten, die den Anschein einer synchronen Instanziierung erwecken sollen, ohne jedoch die Nachteile wie Einfrieren oder Ruckeln in der Anwendung zu verursachen, sollten den Inkubationsmodus „ AsynchronousIfNested “ verwenden.