mx.core
接口public interface IRepeater
实现器 Repeater

IRepeater 接口为 Repeater 对象的 Repeater 公共 API 定义 API。



公共属性
 属性定义方
  container : IContainer
[只读 (read-only)] 包含此 Repeater 的容器,此 Repeater 将在该容器中创建其子项。
IRepeater
  count : int
此 Repeater 应执行的次数。
IRepeater
  currentIndex : int
[只读 (read-only)] Repeater 执行时,当前正在处理的 dataProvider 中项目的索引。
IRepeater
  currentItem : Object
[只读 (read-only)] 此 Repeater 执行时,当前正在处理的 dataProvider 中的项目。
IRepeater
  dataProvider : Object
此 Repeater 创建其子项的重复实例时使用的数据提供程序。
IRepeater
  recycleChildren : Boolean
布尔值标志,指示此 Repeater 是重新使用以前创建的子项还是创建新子项。
IRepeater
  startingIndex : int
dataProvider 中的索引,此 Repeater 从此索引位置开始创建子项。
IRepeater
公共方法
 方法定义方
  
对此 Repeater 创建的所有 UIComponent 执行绑定。
IRepeater
  
初始化新的 Repeater 对象。
IRepeater
属性详细信息
container属性
container:IContainer  [只读 (read-only)]

包含此 Repeater 的容器,此 Repeater 将在该容器中创建其子项。



实现
    public function get container():IContainer
count属性 
count:int  [读写]

此 Repeater 应执行的次数。

如果 Repeater 执行时到达数据提供程序的末尾,则它实际执行的次数将少于所要求的次数。



实现
    public function get count():int
    public function set count(value:int):void
currentIndex属性 
currentIndex:int  [只读 (read-only)]

Repeater 执行时,当前正在处理的 dataProvider 中项目的索引。

Repeater 完成执行后,此属性为 -1。不过,重复组件实例的 repeaterIndex 属性会记住作为其创建基础的 dataProvider 项目的索引。如果是嵌套的 Repeater,您可以使用 repeaterIndices 数组。



实现
    public function get currentIndex():int

另请参见

currentItem属性 
currentItem:Object  [只读 (read-only)]

此 Repeater 执行时,当前正在处理的 dataProvider 中的项目。

Repeater 完成执行后,此属性为 null。不过,在这种情况下,您可以调用重复组件实例的 getRepeaterItem() 方法以获取作为该组件实例创建基础的 dataProvider 项目。



实现
    public function get currentItem():Object

另请参见

dataProvider属性 
dataProvider:Object  [读写]

此 Repeater 创建其子项的重复实例时使用的数据提供程序。

如果读取 dataProvider 属性,将始终获得 ICollectionView 对象或 null。如果您将 dataProvider 属性设置为 null 之外的任何值,则将根据以下规则转换为 ICollectionView 对象:

必须为 dataProvider 属性指定值,否则 Repeater 组件不会执行。



实现
    public function get dataProvider():Object
    public function set dataProvider(value:Object):void
recycleChildren属性 
recycleChildren:Boolean  [读写]

布尔值标志,指示此 Repeater 是重新使用以前创建的子项还是创建新子项。

如果为 true,则当此 Repeater 的 dataProviderstartingIndexcount 更改时,它会通过将新数据绑定到现有子项循环使用现有子项。如果需要增加子项,则不断创建和添加子项。如果需要减少子项,则删除多余子项并将其作为垃圾回收。

如果为 false,则当此 Repeater 的 dataProviderstartingIndexcount 更改时,它将删除以前创建的所有子项,并基于新的数据项创建和添加新子项。

默认情况下,此属性为 false。将其设置为 true 可提高性能,但并不适用于所有情况。例如,如果以前创建的子项包含状态信息,如用户键入的文本,则循环使用子项时不会重置此状态。



实现
    public function get recycleChildren():Boolean
    public function set recycleChildren(value:Boolean):void
startingIndex属性 
startingIndex:int  [读写]

dataProvider 中的索引,此 Repeater 从此索引位置开始创建子项。



实现
    public function get startingIndex():int
    public function set startingIndex(value:int):void
方法详细信息
executeChildBindings()方法
public function executeChildBindings():void

对此 Repeater 创建的所有 UIComponent 执行绑定。

此方法由 Flex 框架调用。开发人员不应调用它。

initializeRepeater()方法 
public function initializeRepeater(container:IContainer, recurse:Boolean):void

初始化新的 Repeater 对象。

此方法由 Flex 框架调用。开发人员不应调用它。

参数

container:IContainer — 包含此 Repeater 的容器,此 Repeater 将在该容器中创建其子项。
 
recurse:Boolean — 布尔值标志,指示此 Repeater 是否应创建其子项的所有后代的。