Egret Engine R - v6.0.0
    Preparing search index...

    ArrayCollection 类是数组的集合类数据结构包装器,可使用ICollection接口的方法和属性对其进行访问和处理。 使用这种数据结构包装普通数组,能在数据源发生改变的时候主动通知视图刷新变更数据项。

    CollectionEvent.COLLECTION_CHANGE 当 ArrayCollection 更新的的时候会派发此事件。

    source

    Egret 2.4

    eui 1.0

    Web

    extension/eui/collections/ArrayCollectionExample.ts

    zh_CN

    Hierarchy

    • EventDispatcher
      • ArrayCollection

    Implements

    Index
    • get source(): any[]

      数据源 通常情况下请不要直接调用Array的方法操作数据源,否则对应的视图无法收到数据改变的通知。通常都是通过ICollection的接口方法来查看数据。 若对数据源进行了修改,请手动调用refresh()方法刷新数据。

      Returns any[]

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • set source(value: any[]): void

      Parameters

      • value: any[]

      Returns void

    • 在对数据源进行排序或过滤操作后可以手动调用此方法刷新所有数据,以更新视图。 ArrayCollection 不会自动检原始数据进行了改变,所以你必须调用refresh()方法去更新显示。

      Returns void

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 向列表末尾添加指定项目。等效于 addItemAt(item, length)

      Parameters

      • item: any

        要被添加的项。

      Returns void

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 在指定的索引处添加项目。 任何大于已添加项目的索引的项目索引都会增加 1。 如果指定的索引比0小或者比最大长度要大。则会抛出1007异常。

      Parameters

      • item: any

        要添加的项

      • index: number

        要添加的指定索引位置

      Returns void

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 获取指定索引处的项目。

      Parameters

      • index: number

        要得到的项的指定位置。

      Returns any

      在索引位置的项,如果没有该项则返回null。

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 如果项目位于列表中,返回该项目的索引。否则返回-1。

      Parameters

      • item: any

        要查找的项。

      Returns number

      项的索引,如果该项没有在列表中将返回-1.

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 通知视图,某个项目的属性已更新。

      Parameters

      • item: any

        视图中需要被更新的项。

      Returns void

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 删除指定索引处的项目并返回该项目。原先位于此索引之后的所有项目的索引现在都向前移动一个位置。

      Parameters

      • index: number

        要被移除的项的索引。

      Returns any

      被移除的项。

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 替换在指定索引处的项目,并返回该项目。

      Parameters

      • item: any

        要在指定索引放置的新的项。

      • index: number

        要被替换的项的索引位置。

      Returns any

      被替换的项目,如果没有该项则返回null

      Egret 2.4

      eui 1.0

      Web

      zh_CN

    • 用新数据源替换原始数据源,此方法与直接设置source不同,它不会导致目标视图重置滚动位置。

      Parameters

      • newSource: any[]

        新数据。

      Returns void

      Egret 2.4

      eui 1.0

      Web

      zh_CN