QQmlIncubator Class

Description détaillée

La création d'objets QML - comme les délégués dans une vue ou une nouvelle page dans une application - peut prendre un temps considérable, en particulier sur les appareils mobiles à ressources limitées. Lorsqu'une application utilise directement QQmlComponent::create(), l'instance de l'objet QML est créée de manière synchrone, ce qui, en fonction de la complexité de l'objet, peut entraîner des pauses ou des bégaiements notables dans l'application.

L'utilisation de QQmlIncubator permet de mieux contrôler la création d'un objet QML, et notamment de le créer de manière asynchrone en utilisant le temps d'inactivité de l'application. L'exemple suivant montre une utilisation simple de QQmlIncubator.

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

Laissez l'incubateur fonctionner pendant un certain temps (normalement en renvoyant le contrôle à la boucle d'événements), puis interrogez-le. Il y a plusieurs façons de revenir à l'incubateur plus tard. Vous pouvez vouloir vous connecter à l'un des signaux envoyés par QQuickWindow, ou vous pouvez lancer un QTimer spécialement pour cela. Vous pouvez également avoir besoin de l'objet dans un but précis et interroger l'incubateur lorsque ce besoin se présente.

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

Les incubateurs asynchrones sont contrôlés par un QQmlIncubationController défini sur QQmlEngine, qui indique au moteur quand l'application est inactive et que les objets incubés doivent être traités. Si aucun contrôleur d'incubation n'est défini sur QQmlEngine, QQmlIncubator crée des objets de manière synchrone, indépendamment de IncubationMode. Par défaut, aucun contrôleur d'incubation n'est défini. Cependant, QQuickView, QQuickWindow et QQuickWidget définissent tous des contrôleurs d'incubation sur leurs QQmlEnginerespectifs. Ces contrôleurs d'incubation espacent les incubations sur plusieurs images pendant que la vue est rendue.

QQmlIncubator prend en charge trois modes d'incubation :

• Synchrone La création se produit de manière synchrone. C'est-à-dire qu'une fois que l'appel QQmlComponent::create() est retourné, l'incubateur est déjà dans l'état Error ou Ready. Un incubateur synchrone n'a pas d'avantage réel par rapport à l'utilisation directe des méthodes de création synchrone sur QQmlComponent, mais il peut simplifier la mise en œuvre d'une application en utilisant la même API pour les créations synchrones et asynchrones.
• Asynchrone (par défaut) La création se produit de manière asynchrone, en supposant qu'un QQmlIncubatorController soit défini sur le site QQmlEngine.

  L'incubateur reste dans l'état Loading jusqu'à ce que la création soit terminée ou qu'une erreur se produise. Le rappel statusChanged() peut être utilisé pour être informé des changements d'état.

  Les applications doivent utiliser le mode d'incubation asynchrone pour créer des objets qui ne sont pas nécessaires immédiatement. Par exemple, le type ListView utilise l'incubation asynchrone pour créer des objets qui sont légèrement hors de l'écran pendant le défilement de la liste. Si, au cours de la création asynchrone, l'objet est nécessaire immédiatement, la méthode QQmlIncubator::forceCompletion() peut être appelée pour terminer le processus de création de manière synchrone.

• AsynchronousIfNested La création se fera de manière asynchrone si elle fait partie d'une création asynchrone imbriquée, ou de manière synchrone dans le cas contraire.

  Dans la plupart des scénarios où un composant QML veut avoir l'apparence d'une instanciation synchrone, il doit utiliser ce mode.

  La meilleure façon d'expliquer ce mode est de le présenter à l'aide d'un exemple. Lorsque le type ListView est créé pour la première fois, il doit se doter d'un ensemble initial de délégués à afficher. Si le site ListView a une hauteur de 400 pixels et que chaque délégué a une hauteur de 100 pixels, il doit créer quatre instances de délégués initiales. Si le site ListView utilise le mode d'incubation asynchrone, le site ListView sera toujours créé vide, puis, un peu plus tard, les quatre éléments initiaux apparaîtront.

  Inversement, si le site ListView utilisait le mode d'incubation synchrone, il se comporterait correctement mais pourrait introduire des bégaiements dans l'application. Comme QML devrait s'arrêter et instancier les délégués de ListView de manière synchrone, si ListView faisait partie d'un composant QML qui était instancié de manière asynchrone, cela annulerait une grande partie des avantages de l'instanciation asynchrone.

  Le mode AsynchronousIfNested résout ce problème. En utilisant AsynchronousIfNested, les délégués ListView sont instanciés de manière asynchrone si le ListView lui-même fait déjà partie d'une instanciation asynchrone, et de manière synchrone dans le cas contraire. Dans le cas d'une instanciation asynchrone imbriquée, l'instanciation asynchrone externe ne s'achèvera que lorsque toutes les instanciations imbriquées se seront également achevées. Cela garantit qu'au moment où l'instanciation asynchrone externe se termine, les éléments internes tels que ListView ont déjà terminé le chargement de leurs délégués initiaux.

  Il est presque toujours incorrect d'utiliser le mode d'incubation synchrone - les éléments ou les composants qui veulent l'apparence d'une instanciation synchrone, mais sans les inconvénients d'introduire des gels ou des bégaiements dans l'application, devraient utiliser le mode d'incubation AsynchronousIfNested.