Repeater QML Type

该属性保存model 中的项目数。

count 的值并不总是与实例化的delegates 的数量一致；使用itemAt() 检查给定索引处的委托是否存在。如果委托没有实例化，则返回null 。

• 当 Repeater 正在实例化委托时（启动时或由于model 的更改），会为每个创建的委托发出itemAdded 信号，随后count 属性也会更改。
• 如果 Repeater 不是已完成的可视化层次结构的一部分，count 会反映模型大小，但不会创建委托。
• 如果 Repeater 因model 更改而销毁委托，则会为每个委托发出itemRemoved() 信号，随后count 属性也会更改。
• 如果 Repeater 被移出可视化层次结构（例如通过设置parent = null ），则会销毁委托，每个委托都会发出itemRemoved() 信号，但count 不会改变。

另请参阅 itemAt()、itemAdded() 和itemRemoved()。

委托提供了一个模板，定义了中继器实例化的每个项目。

委托暴露于一个只读的index 属性，该属性指示委托在中继器中的索引。例如，以下Text 委托会显示每个重复项的索引：

Column {
    Repeater {
        model: 10
        Text {
            required property int index
            text: "I'm item " + index
        }
    }
}

如果model 是一个字符串列表或对象列表，则委托也会显示一个只读的modelData 属性，该属性保存字符串或对象数据。例如

Column {
    Repeater {
        model: ["apples", "oranges", "pears"]
        Text {
            required property string modelData
            text: "Data: " + modelData
        }
    }
}

如果model 是一个模型对象（如ListModel ），委托就可以访问所有作为命名属性的模型角色，就像委托访问视图类（如ListView ）一样。

另请参阅 QML 数据模型。

该属性决定了代表如何访问模型。

默认值为DelegateModel.Qt5ReadWrite 。

另请参阅 Qt Quick#更改模型数据中的模型和视图。

为中继器提供数据的模型。

此属性可设置为任何支持的数据模型：

• 一个数字，表示中继器要创建的代表数目
• 模型（例如ListModel 项目或QAbstractItemModel 子类）
• 字符串列表
• 对象列表

模型的类型会影响delegate 所显示的属性。

另请参阅 数据模型。

当一个项目被添加到中继器时，就会发出该信号。index 参数包含项目插入中继器的索引，而item 参数则包含已添加的Item 。

当项目从中继器中移除时，将发出该信号。index 参数包含项目从中继器中移除时的索引，而item 参数则包含被移除的Item 。

如果item 是由该中继器创建的，则不要保留对它的引用，因为在这种情况下，它将在信号处理后不久被删除。

返回在给定的index 上创建的Item ，如果index 上不存在项目，则返回null 。