QQmlIncubator Class

Descripción detallada

La creación de objetos QML - como delegados en una vista, o una nueva página en una aplicación - puede llevar un tiempo considerable, especialmente en dispositivos móviles con recursos limitados. Cuando una aplicación utiliza QQmlComponent::create() directamente, la instancia del objeto QML se crea de forma sincrónica, lo que, dependiendo de la complejidad del objeto, puede provocar pausas o tartamudeos notables en la aplicación.

El uso de QQmlIncubator ofrece un mayor control sobre la creación de un objeto QML, lo que incluye la posibilidad de crearlo de forma asíncrona utilizando el tiempo de inactividad de la aplicación. El siguiente ejemplo muestra un uso simple de QQmlIncubator.

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

Deje que la incubadora se ejecute durante un tiempo (normalmente devolviendo el control al bucle de eventos) y, a continuación, sondeela. Hay varias maneras de volver a la incubadora más tarde. Es posible que desee conectarse a una de las señales enviadas por QQuickWindow, o puede que desee ejecutar un QTimer especialmente para eso. También puedes necesitar el objeto para algún propósito específico y sondear la incubadora cuando surja ese propósito.

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

Las incubadoras asíncronas son controladas por un QQmlIncubationController que se establece en el QQmlEngine, que permite al motor saber cuando la aplicación está inactiva y los objetos de incubación deben ser procesados. Si no se establece un controlador de incubación en el QQmlEngine, QQmlIncubator crea objetos de forma sincrónica independientemente del IncubationMode especificado. Por defecto, no se establece ningún controlador de incubación. Sin embargo, QQuickView, QQuickWindow y QQuickWidget establecen controladores de incubación en sus respectivos QQmlEngines. Estos controladores de incubación espacian las incubaciones a lo largo de múltiples fotogramas mientras se renderiza la vista.

QQmlIncubator soporta tres modos de incubación:

• Sincrónica La creación se produce de forma sincrónica. Es decir, una vez que la llamada QQmlComponent::create() retorna, la incubadora ya estará en estado Error o Listo. Una incubadora síncrona no tiene ninguna ventaja real en comparación con el uso de los métodos de creación síncrona en QQmlComponent directamente, pero puede simplificar la implementación de una aplicación para utilizar la misma API tanto para creaciones síncronas como asíncronas.
• Asíncrono (por defecto) La creación se produce de forma asíncrona, asumiendo que se ha establecido un QQmlIncubatorController en QQmlEngine.

  La incubadora permanecerá en el estado Loading hasta que se complete la creación o se produzca un error. La llamada de retorno statusChanged() se puede utilizar para ser notificado de los cambios de estado.

  Las aplicaciones deberían utilizar el modo de incubación Asíncrono para crear objetos que no se necesiten inmediatamente. Por ejemplo, el tipo ListView utiliza la incubación asíncrona para crear objetos que están ligeramente fuera de la pantalla mientras se desplaza la lista. Si, durante la creación asíncrona, el objeto se necesita inmediatamente, se puede llamar al método QQmlIncubator::forceCompletion() para completar el proceso de creación de forma síncrona.

• AsynchronousIfNested La creación se producirá de forma asíncrona si forma parte de una creación asíncrona anidada, o de forma síncrona en caso contrario.

  En la mayoría de los escenarios en los que un componente QML desea la apariencia de una instanciación síncrona, debería utilizar este modo.

  Este modo se explica mejor con un ejemplo. Cuando el tipo ListView se crea por primera vez, necesita poblarse con un conjunto inicial de delegados para mostrar. Si ListView tuviera 400 píxeles de alto y cada delegado tuviera 100 píxeles de alto, necesitaría crear cuatro instancias de delegado iniciales. Si el ListView utilizara el modo de incubación asíncrono, el ListView se crearía siempre vacío y, algún tiempo después, aparecerían los cuatro elementos iniciales.

  Por el contrario, si ListView utilizara el modo de incubación Síncrono se comportaría correctamente pero podría introducir tartamudeos en la aplicación. Como QML tendría que detenerse e instanciar los delegados de ListView de forma sincrónica, si ListView formara parte de un componente QML que se instanciara de forma asincrónica, esto anularía gran parte de las ventajas de la instanciación asincrónica.

  El modo AsynchronousIfNested resuelve este problema. Al utilizar AsynchronousIfNested, los delegados de ListView se instancian de forma asíncrona si el propio ListView ya forma parte de una instanciación asíncrona, y de forma síncrona en caso contrario. En el caso de una instanciación asíncrona anidada, la instanciación asíncrona externa no se completará hasta que todas las instancias anidadas también hayan finalizado. Esto garantiza que, para cuando finalice la instanciación asíncrona externa, los elementos internos como ListView ya hayan terminado de cargar sus delegados iniciales.

  Casi siempre es incorrecto utilizar el modo de incubación síncrono - los elementos o componentes que quieran la apariencia de la instanciación síncrona, pero sin los inconvenientes de introducir congelaciones o tartamudeos en la aplicación, deberían utilizar el modo de incubación AsynchronousIfNested.