ArrayCollection 类是数组的集合类数据结构包装器,可使用ICollection接口的方法和属性对其进行访问和处理。 使用这种数据结构包装普通数组,能在数据源发生改变的时候主动通知视图刷新变更数据项。
ICollection
CollectionEvent.COLLECTION_CHANGE 当 ArrayCollection 更新的的时候会派发此事件。
source
Egret 2.4
eui 1.0
Web
extension/eui/collections/ArrayCollectionExample.ts
zh_CN
构造函数。
Optional
数据源 通常情况下请不要直接调用Array的方法操作数据源,否则对应的视图无法收到数据改变的通知。通常都是通过ICollection的接口方法来查看数据。 若对数据源进行了修改,请手动调用refresh()方法刷新数据。
此集合中的项目数。0 表示不包含项目。 *
在对数据源进行排序或过滤操作后可以手动调用此方法刷新所有数据,以更新视图。 ArrayCollection 不会自动检原始数据进行了改变,所以你必须调用refresh()方法去更新显示。
refresh()
向列表末尾添加指定项目。等效于 addItemAt(item, length)。
addItemAt(item, length)
要被添加的项。
在指定的索引处添加项目。 任何大于已添加项目的索引的项目索引都会增加 1。 如果指定的索引比0小或者比最大长度要大。则会抛出1007异常。
要添加的项
要添加的指定索引位置
获取指定索引处的项目。
要得到的项的指定位置。
在索引位置的项,如果没有该项则返回null。
如果项目位于列表中,返回该项目的索引。否则返回-1。
要查找的项。
项的索引,如果该项没有在列表中将返回-1.
通知视图,某个项目的属性已更新。
视图中需要被更新的项。
删除列表中的所有项目。
删除指定索引处的项目并返回该项目。原先位于此索引之后的所有项目的索引现在都向前移动一个位置。
要被移除的项的索引。
被移除的项。
替换在指定索引处的项目,并返回该项目。
要在指定索引放置的新的项。
要被替换的项的索引位置。
被替换的项目,如果没有该项则返回null 。
null
用新数据源替换原始数据源,此方法与直接设置source不同,它不会导致目标视图重置滚动位置。
新数据。
ArrayCollection 类是数组的集合类数据结构包装器,可使用
ICollection接口的方法和属性对其进行访问和处理。 使用这种数据结构包装普通数组,能在数据源发生改变的时候主动通知视图刷新变更数据项。CollectionEvent.COLLECTION_CHANGE 当 ArrayCollection 更新的的时候会派发此事件。
Default Property
source
Version
Egret 2.4
Version
eui 1.0
Platform
Web
Include Example
extension/eui/collections/ArrayCollectionExample.ts
Language
zh_CN