C

组件 QML 类型

封装了一个 QML 组件定义。 更多信息...

导入语句import QtQuick

附加信号

详细描述

组件是可重复使用的、封装良好的 QML 类型,具有明确定义的接口。

组件通常由组件文件定义,也就是说,.qml 文件。Component 类型允许 QML 组件在 QML 文档中定义,而不作为单独的 QML 文件。

Component 类型通常用于提供视图的图形组件。例如,ListView::delegate 和 Repeater::delegate 属性要求 Component 指定每个列表项应如何显示。

import QtQuick 2.15

Item {
    Component {
        id: redSquare

        Rectangle {
            color: "red"
            width: 10
            height: 10
        }
    }

    Row {
        Repeater {
            model: 3
            delegate: redSquare
        }
    }
}

定义 Component 类似于定义 QML 文档。QML 文档包含一个顶级项,该项定义组件的行为和属性。它不能在顶级项之外定义属性或行为。同样,Component 定义包含一个顶级项(在上面的例子中是 Rectangle),不能在此项之外定义任何数据,名誉除外。

另请参阅 模型-视图-代理模式

附加信号文档

completed()

对象实例化后发出。这可以用于在 QML 环境准备好后执行启动脚本代码。

对应的处理程序是 onCompleted。它可以在任何对象上声明。运行 onCompleted 处理程序的顺序是未定义的。

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

注意: 对应的处理程序是 onCompleted。


在某些 Qt 许可下提供。
了解更多信息。