包 | mx.collections |
接口 | public interface IGroupingCollection2 extends IHierarchicalData , IEventDispatcher |
实现器 | GroupingCollection2 |
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
相关 API 元素
公共方法
方法 | 由以下参数定义 | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | IEventDispatcher | ||
如果异步执行刷新,请取消刷新操作并停止构建组。 | IGroupingCollection2 | ||
如果该节点可以包含子项,则返回 true。 | IHierarchicalData | ||
将事件调度到事件流中。 | IEventDispatcher | ||
返回表示节点子项的 Object。 | IHierarchicalData | ||
返回节点中的数据。 | IHierarchicalData | ||
返回根数据项。 | IHierarchicalData | ||
如果该节点包含子项,则返回 true。 | IHierarchicalData | ||
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | IEventDispatcher | ||
对该集合应用分组。 | IGroupingCollection2 | ||
从 EventDispatcher 对象中删除侦听器。 | IEventDispatcher | ||
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | IEventDispatcher |
属性详细信息
grouping | 属性 |
方法详细信息
cancelRefresh | () | 方法 |
public function cancelRefresh():void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 10, AIR 1.5 |
如果异步执行刷新,请取消刷新操作并停止构建组。与异步刷新相对应,此方法仅取消由调用带有 asynch
参数 true
的 refresh()
方法启动的刷新。
refresh | () | 方法 |
public function refresh(async:Boolean = false, dispatchCollectionEvents:Boolean = false):Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 10, AIR 1.5 |
对该集合应用分组。该集合不会自动检测对组进行的更改,因此设置 grouping
、source
或 summaries
属性后,必须调用 refresh()
方法以更新该集合。修改集合的 GroupingField(如通过更改 caseInsensitive
、compareFunction
或 groupingFunction
属性)时您也调用 refresh()
方法。
可以同步或异步应用 refresh()
方法。
同步调用 refresh()
时,在该方法返回之前,会一起更新所有组和摘要。这意味着您的应用程序在该调用期间无法执行其它处理操作。客户端应等待 kind
属性值设置为 CollectionEventKind.REFRESH
的 CollectionEvent 事件,以确保完成 refresh()
方法。
在异步刷新中,会单独更新所有组和摘要。refresh()
方法在更新组和摘要之前返回,这样您的应用程序可以继续执行。此外,控件是在刷新过程中更新的,这样用户可以继续与其交互。
单独更新组和摘要(而不是一次全部更新)的开销使异步刷新比同步刷新花费的时间更长。但是,对于大型数据集,您的应用程序会在刷新过程中继续操作。
参数
async:Boolean (default = false ) — 如果为 true ,则定义为异步刷新。默认情况下,为 false ,指示同步刷新。
| |
dispatchCollectionEvents:Boolean (default = false ) — 若为 true ,则当形成组时调度事件。为了使性能更佳,可将其设置为 false 。若为 true ,则事件是作为组调度的,且会同步计算摘要以更新控件。注意:如果 async 为 true ,则会始终将 dispatchCollectionEvents 设置为 true 。默认情况下,它为 false ,指示将不会调度任何事件。
|
Boolean — 如果 refresh() 方法已完成,则为 true ;如果刷新尚未完成,则为 false ,这样可以表示这些项目仍未处理。
|
Tue Jun 12 2018, 11:04 AM Z