Repeater3D QML 类型

使用提供的模型实例化多个基于节点组件。 更多信息...

导入语句import QtQuick3D
继承自

Node

由以下继承

InstanceRepeater

属性

信号

方法

详细描述

Repeater3D 类型用于创建大量相似项。与其他视图类型一样,Repeater3D 有一个 模型 和一个 委托:对于模型中的每个条目,委托在用一个来自模型的数据种子的上下文中实例化。

Repeaters 的 模型 可以是支持的任何 数据模型。此外,类似于其他视图的委托,Repeaters 委托可以访问其在 repeater 中的索引,以及与委托相关的模型数据。有关详细信息,请参阅 委托 属性文档。

注意:Repeater3D 项拥有其创建的所有项。删除或动态销毁由 Repeater3D 创建的项会导致不可预测的行为。

注意:Repeater3D 是基于 Node 的,并且只能重复 Node 提取的对象。

属性文档

count : int [只读]

该属性保持模型中项的数量。

注意:如果 Repeater3D 正在实例化委托或配置不正确,则通过 count 报告的模型中项的数量可能与创建的委托数量不同。


delegate : Component [默认]

委托提供由重复器实例化的每个对象的模板。

委托公开了对只读 index 属性的访问,该属性指示委托在重复器中的索引。

如果 模型 是一个模型对象(例如 ListModel),委托可以像访问 ListView 等视图类的属性一样,访问所有模型角色,按名称属性的方式。

另请参阅QML 数据模型


model : 任何类型

为重复器提供数据的模型。

此属性可以设置为受支持的任意 数据模型

  • 一个表示重复器将创建的委托数量的数字
  • 一个模型(例如一个 ListModel 项目,或 QAbstractItemModel 子类)
  • 一个字符串列表
  • 一个对象列表

模型的类型会影响暴露给 委托 的属性。

另请参阅数据模型


信号文档

objectAdded(int index, Object3D object)

当对象被添加到重复器时,会发出此信号。参数 index 包含对象在重复器中插入的索引,参数 object 包含被添加的 Object3D

相应处理器是 onObjectAdded

注意:相应处理器是 onObjectAdded


objectRemoved(int index, Object3D object)

当对象从重复器中移除时,会发出此信号。参数 index 包含项目在重复器中被移除的索引,参数 object 包含被移除的 Object3D

如果 object 是由重复器创建的,不要保留对它的引用,因为这些情况下,在信号被处理不久之后它将被删除。

相应处理器是 onObjectRemoved

注意:相应处理器是 onObjectRemoved


方法文档

Object3D objectAt(index)

返回给定 index 处创建的 Object3D,如果 index 处不存在则返回 null


© 2024 The Qt Company Ltd。包含在此处的文档贡献由其各自的拥有者所有。此处提供的文档是根据由自由软件基金会发布的 GNU 自由文档许可证版本 1.3 许可的。Qt 和相应的标志是芬兰以及/或世界其他地区的 The Qt Company Ltd. 的商标。所有其他商标均为其各自所有者的财产。