Loader3D QML 类型

This property is true if the Loader3D is currently active. The default value for this property is true.

If the Loader3D is inactive, changing the source or sourceComponent will not cause the item to be instantiated until the Loader3D is made active.

Установка значения на неактивное вызовет освобождение любого item загруженного загружателем, но не将对 source или sourceComponent повлиять.

非活动状态下的加载器状态始终为Null。

另请参阅 source 和 sourceComponent。

此属性表示组件是否将异步实例化。默认情况下为false。

当与source属性一起使用时，加载和编译将在后台线程中执行。

异步加载会在多个帧中创建组件声明的对象，从而降低动画中出错的概率。当异步加载时，状态将更改为Loader3D.Loading。一旦创建整个组件，item将可用，状态将更改为Loader.Ready。

在异步加载进行时更改此属性的值到false将强制立即、同步地完成。这允许开始异步加载，然后在异步加载完成之前立即强制完成，以便在异步加载完成之前访问Loader3D内容。

为了防止看到项目逐渐加载，请设置适当的visible，例如。

Loader3D {
    source: "mycomponent.qml"
    asynchronous: true
    visible: status == Loader3D.Ready
}

请注意，此属性仅影响对象实例化；它与通过网络异步加载组件无关。

此属性保存当前已加载的最高级别对象。

此属性保存从网络加载QML数据的进度，从0.0（未加载任何内容）到1.0（完成）。大多数QML文件都很小，因此此值将快速从0变为1。

另请参阅 status。

此属性保存要实例化的QML组件的URL。

为了卸载当前加载的对象，将此属性设置为一个空字符串，或将sourceComponent设置为undefined。将source设置为新URL还将导致卸载由先前URL创建的项目。

另请参阅 sourceComponent，status 和 progress。

此属性保存要实例化的Component。

Item {
    Component {
        id: redCube
        Model {
            source: "#Cube"
            materials: DefaultMaterial {
                diffuseColor: "red"
            }
        }
    }

    Loader3D { sourceComponent: redCube }
    Loader3D { sourceComponent: redCube; x: 10 }
}

为了卸载当前加载的对象，将此属性设置为undefined。

另请参阅 source 和 progress。

此属性保存QML加载的状态。它可以是以下之一：

使用此状态提供更新或以某种方式响应状态变化。例如，您可以

• 触发状态更改

  State { name: 'loaded'; when: loader.status == Loader3D.Ready }

• 实现onStatusChanged信号处理器

  Loader3D {
      id: loader
      onStatusChanged: if (loader.status == Loader3D.Ready) console.log('Loaded')
  }

• 绑定到状态值

  Text { text: loader.status == Loader3D.Ready ? 'Loaded' : 'Not loaded' }

请注意，如果源文件是本地文件，状态将最初为“就绪”（或者“错误”）。在这种情况下将没有onStatusChanged信号，但onLoaded仍然会被调用。

另请参见 progress。

当status变为Loader3D.Ready或成功初始化加载时，将发出此信号。

相应的事件处理器是onLoaded。

创建给定source组件的对象实例，它将具有给定的properties。 properties参数是可选的。在加载和实例化完成后，将通过item属性访问实例。

如果在此函数被调用时active属性为false，则会话给定的source组件将不会被加载，但source和初始的properties将被缓存。当加载器被置为active时，将使用初始的properties创建source组件的实例。

以这种方式设置组件实例的初始属性值将不会触发任何相关Behavior。

注意，如果在设置加载器active之前调用此函数后更改source或sourceComponent，则缓存的properties将被清除。

另请参见 source和active。