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 支持三种孵化模式：

• 同步 创建是同步进行的。也就是说，一旦QQmlComponent::create() 调用返回，孵化器就会处于错误或就绪状态。与直接使用QQmlComponent 上的同步创建方法相比，同步孵化器并无实际优势，但同步和异步创建使用相同的 API 可以简化应用程序的实现。
• 异步（默认） 假设在QQmlEngine 上设置了 QQmlIncubatorController，创建将以异步方式进行。

  孵化器将保持加载状态，直到创建完成或出现错误。statusChanged() 回调可用于通知状态变化。

  应用程序应使用异步孵化模式创建不需要立即使用的对象。例如，ListView 类型使用异步孵化来创建在滚动列表时略微偏离屏幕的对象。如果在异步创建过程中需要立即创建对象，可以调用QQmlIncubator::forceCompletion() 方法同步完成创建过程。

• AsynchronousIfNested 如果是嵌套异步创建的一部分，创建将以异步方式进行；如果不是嵌套异步创建的一部分，创建将以同步方式进行。

  在大多数情况下，如果 QML 组件希望获得同步实例化的外观，就应该使用这种模式。

  最好用一个例子来解释这种模式。当ListView 类型首次创建时，它需要用一组初始委托来填充自己。如果ListView 的高度为 400 像素，而每个委托的高度为 100 像素，则需要创建四个初始委托实例。如果ListView 使用的是异步孵化模式，那么ListView 将始终为空，然后，在某个时候，四个初始项目就会出现。

  相反，如果ListView 使用同步孵化模式，虽然行为正确，但可能会给应用程序带来卡顿。由于 QML 必须停止并同步实例化ListView 的委托，如果ListView 是异步实例化的 QML 组件的一部分，异步实例化的好处就会大打折扣。

  AsynchronousIfNested 模式解决了这个问题。通过使用AsynchronousIfNested ，如果ListView 本身已经是异步实例化的一部分，那么ListView 委托就会被异步实例化，否则就会被同步实例化。在嵌套异步实例化的情况下，外层异步实例化要等到所有嵌套实例化完成后才能完成。这样可以确保在外部异步实例化完成时，内部项目（如ListView ）已经完成了初始委托的加载。

  使用同步实例化模式几乎总是不正确的--如果元素或组件希望获得同步实例化的外观，但又不想在应用程序中引入冻结或停顿的缺点，则应使用AsynchronousIfNested 实例化模式。