DelegateModelGroup QML Type

封装经过筛选的可视化数据项集。更多

• 所有成员（包括继承成员）的列表

属性

• count : int
• includeByDefault : bool
• name : string

信号

• changed(array removed, array inserted)

方法

• void addGroups(int index, int count, list<string> groups)
• var create(int index)
• var create(jsdict data, array groups)
• var create(int index, jsdict data, array groups)
• object get(int index)
• void insert(jsdict data, var groups)
• void insert(int index, jsdict data, array groups)
• void move(var from, var to, int count)
• void remove(int index, int count)
• void removeGroups(int index, int count, list<string> groups)
• void resolve(int from, int to)
• void setGroups(int index, int count, list<string> groups)

详细描述

DelegateModelGroup 类型提供了一种方法来处理DelegateModel 的委托项的模型数据，以及对这些委托项进行排序和过滤。

DelegateModel 中可实例化的委托项的初始集由items 组表示，该组通常直接反映分配给DelegateModel::model 的模型内容。通过将该 DelegateModelGroup 的name 分配给DelegateModel::filterOnGroup 属性，可将该组更改为DelegateModel::groups 的任何其他成员的内容。

可以使用get() 函数访问 DelegateModelGroup 中项目的数据，该函数会返回有关组成员和索引以及模型数据的信息。结合move() 函数，可使用remove() 实现视图排序，将项目从视图中过滤出来，或使用setGroups() 和Package 委托将项目分类到不同的视图中。不同的组只有在互不关联的情况下才能独立排序。移动一个组中的项目也会移动它所属的所有其他组。

可以使用insert() 函数将数据直接插入 DelegateModelGroup，从而补充模型中的数据。这可用于在视图中引入模拟项或占位符项，当真正的模型数据可用时，resolved 。

委托项目也可以使用create() 函数直接从 DelegateModelGroup 实例化，这样就可以在没有附带视图类型的情况下使用DelegateModel ，或挑选应被实例化的特定项目，而不管它们当前是否在视图的可见区域内。

另请参阅 《QML 动态视图排序教程》。

属性文档

count : int [read-only]

此属性表示组中项目的数量。

includeByDefault : bool

该属性表示新项目是否默认分配给该组。

name : string

该属性包含组的名称。

模型中的每个组必须有一个以小写字母开头的唯一名称。

信号文档

changed(array removed, array inserted)

当项目从组中移出或插入时，就会发出该信号。

removed 和inserted 数组中的每个对象都有两个值：第一个插入或移除项目的索引，以及连续插入或移除项目的计数。

每个索引都会根据之前的更改进行调整，所有移除的项目都在任何插入的项目之前。

方法文档

void addGroups(int index, int count, list<string> groups)

将count 项目从index 开始添加到groups 。

返回组中index 的实例化项目的引用。

如果提供了data 对象，它将被inserted ，地址为index ，并将返回一个引用该新条目的项目。可选的groups 参数用于确定新条目所属的组，如果未指定，则等于调用create() 的组。

创建返回的所有条目都将添加到persistedItems 组。当未被任何视图引用时，该组中的项目将保持实例化。

object get(int index)

返回描述组中index 项目的 javascript 对象。

返回的对象包含与DelegateModel 所附代表可用的相同信息，以及该项目的模型。它具有以下属性

• 模型项目的模型数据。这与委托中的模型上下文属性相同
• groups项目所属组的名称列表。可以通过写入此属性来更改项目的成员身份。
• inItems项目是否属于items 组。写入此属性将从组中添加或删除项目。
• itemsIndex items 组中项目的索引。
• in<GroupName>项目是否属于动态组groupName。向该属性写入内容将从组中添加或删除项目。
• <groupName>Index项目在动态组groupName 中的索引。
• isUnresolved项目是否与分配给DelegateModel::model 的模型中的索引绑定。如果项目未绑定到模型，则返回 true；如果绑定到模型，则返回 false。

在DelegateModel 中的index 处创建一个新条目，其中包含data 中与分配给DelegateModel::model 的模型中的角色相对应的值。

如果没有提供索引，数据将附加到模型中。

可选的groups 参数用于确定新条目所属的组，如果未指定，则等于插入时调用的组。

插入DelegateModel 的数据随后可以使用resolve() 函数与DelegateModel::model 中的现有条目合并。这可用于创建占位项，随后由实际数据取代。

void move(var from, var to, int count)

将from 中的count 移至to 组的新位置。

void remove(int index, int count)

从index 开始删除count 项目。

void removeGroups(int index, int count, list<string> groups)

从groups 删除从index 开始的count 项目。

void resolve(int from, int to)

将from 中的未解决项与DelegateModel::model 中索引to 的项绑定。

未解决项是指数据被inserted 到DelegateModelGroup ，而不是来自DelegateModel::model 索引的条目。解决项目将用未解决项目替换目标索引中的项目。已解决的项将在其绑定索引中反映源模型的数据，并在该索引移动时像其他项一样移动。

如果在DelegateModelGroup onChanged() 处理程序中替换了一个新项目，那么它的插入和替换将作为一个原子操作传达给视图，从而造成模型内容没有改变的假象，或者如果未解决项目和模型项目不相邻，那么以前未解决的项目只是移动了。

void setGroups(int index, int count, list<string> groups)

从index 开始更改count 项目的组成员资格。这些项目将从其现有组中删除，并添加到groups 中。