QQmlIncubator 类

详细说明

创建 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()方法来同步完成创建过程。

• 异步如果嵌套如果创建是嵌套异步创建的一部分，则创建会异步发生，如果不是则同步发生。

  在大多数情况下，当QML组件希望有同步实例化的外观时，应使用此模式。

  这个模式最好用一个例子来解释。当类型ListView第一次创建时，它需要使用一组初始委托来填充自己以显示。如果ListView高400像素，并且每个代理高100像素，则需要创建四个初始代理实例。如果ListView使用异步孵化模式，则ListView始终是创建为空，然后在稍后，四个初始项会出现。

  相反，如果ListView使用同步孵化模式，它将能够正确显示，但这可能会导致应用程序出现卡顿。因为QML需要停止并同步实例化ListView的代理，如果ListView是异步实例化的一部分组件，这可能会取消异步实例化的许多好处。

  异步如果嵌套（AsynchronousIfNested）模式解决了这个问题。通过使用异步如果嵌套，当ListView自身已经是异步实例化的一部分时，ListView的代理将异步实例化；如果不是，将同步实例化。在嵌套异步实例化的情况下，外层异步实例化将在所有嵌套实例化完成后才完成。这确保了在外层异步实例化完成时，内层元素如ListView已经完成了初始代理的加载。

  几乎总是不正确使用同步孵化模式；那些希望有同步实例化外观但又不希望引入应用程序冻结或卡顿的元素或组件应该使用异步如果嵌套孵化模式。