Component QML Type

加载组件的进度，从 0.0（未加载）到 1.0（已完成）。

该属性显示组件加载的状态。状态可以是以下其中之一：

组件 URL。这是用于构建组件的 URL。

对象实例化后发出的信号。一旦建立了完整的 QML 环境，它就可用于在启动时执行脚本代码。

onCompleted 信号处理程序可在任何对象上声明。处理程序的运行顺序未定义。

Rectangle {
    Component.onCompleted: console.log("Completed Running!")
    Rectangle {
        Component.onCompleted: console.log("Nested Completed Running!")
    }
}

在对象开始销毁时发出。该处理程序可用于撤销对completed() 信号或应用程序中其他命令式代码所做的响应。

onDestruction 信号处理程序可以在任何对象上声明。处理程序的运行顺序未定义。

Rectangle {
    Component.onDestruction: console.log("Destruction Beginning!")
    Rectangle {
        Component.onDestruction: console.log("Nested Destruction Beginning!")
    }
}

另请参见 Qt Qml.

创建并返回该组件的对象实例，该实例将具有给定的parent 和properties 。properties 参数为可选参数。如果对象创建失败，则返回空值。

对象将在与创建组件时相同的上下文中创建。如果组件不是在 QML 中创建的，调用此函数时将总是返回空值。

如果您希望创建对象时不设置父对象，请为parent 值指定null 。请注意，如果要显示返回的对象，必须提供有效的parent 值或设置返回对象的parent 属性，否则对象将不可见。

如果未向 createObject() 提供parent ，则必须保留对返回对象的引用，以免该对象被垃圾回收器销毁。无论之后是否设置Item::parent ，情况都是如此，因为设置项父对象并不会改变对象的所有权。改变的只是图形父对象。

从QtQuick 1.1 开始，该方法接受一个可选的properties 参数，用于指定创建对象的初始属性值映射。这些值将在对象创建最终完成前应用。这比在创建对象后设置属性值更有效，尤其是在定义了大量属性值的情况下，而且还允许在创建对象前设置属性绑定（使用Qt.binding ）。

properties 参数被指定为属性值项的映射。例如，下面的代码创建了一个对象，其初始x 和y 值分别为 100 和 100：

const component = Qt.createComponent("Button.qml");
if (component.status === Component.Ready) {
    component.createObject(parent, { x: 100, y: 100 });
}

可使用destroy() 方法删除动态创建的实例。更多信息，请参阅从 JavaScript 动态创建 QML 对象。

另请参阅 incubateObject()。

返回任何错误的人可读描述。

字符串包括每个错误的文件、位置和描述。如果存在多个错误，则用换行符分隔。

如果没有错误，则返回空字符串。

为该组件实例创建孵化器。孵化器允许异步实例化新的组件实例，并且不会导致用户界面冻结。

parent 参数指定了创建实例的父对象。省略该参数或传递空值将创建一个没有父对象的对象。在这种情况下，必须保留对创建对象的引用，以免垃圾回收器将其销毁。

properties mode 可以是 Qt.Synchronous 或 Qt.Asynchronous，用于控制同步或异步创建实例。默认值为异步。在某些情况下，即使指定了 Qt.Synchronous，孵化器也可能以异步方式创建对象。如果调用 incubateObject() 的组件本身是异步创建的，就会出现这种情况。

所有三个参数都是可选的。

如果创建成功，该方法将返回一个孵化器，否则返回空。孵化器具有以下属性：

• status - 孵化器的状态。有效值为 Component.Ready、Component.Loading 和 Component.Error。
• object - 创建的对象实例。只有当孵化器处于就绪状态时才可用。
• onStatusChanged - 指定状态改变时调用的回调函数。状态将作为参数传递给回调函数。
• forceCompletion() - 调用该函数可同步完成孵化。

下面的示例演示了如何使用孵化器：

const component = Qt.createComponent("Button.qml");

const incubator = component.incubateObject(parent, { x: 10, y: 10 });
if (incubator.status !== Component.Ready) {
    incubator.onStatusChanged = function(status) {
        if (status === Component.Ready) {
            print("Object", incubator.object, "is now ready!");
        }
    };
} else {
    print("Object", incubator.object, "is ready immediately!");
}

动态创建的实例可通过destroy() 方法删除。更多信息，请参阅从 JavaScript 动态创建 QML 对象。

另请参阅 createObject().