包 | mx.core |
接口 | public interface IRepeater |
实现器 | Repeater |
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
属性 | 由以下参数定义 | ||
---|---|---|---|
container : IContainer [只读]
包含此 Repeater 的容器,此 Repeater 将在该容器中创建其子项。 | IRepeater | ||
count : int
此 Repeater 应执行的次数。 | IRepeater | ||
currentIndex : int [只读]
Repeater 执行时,当前正在处理的 dataProvider 中项目的索引。 | IRepeater | ||
currentItem : Object [只读]
此 Repeater 执行时,当前正在处理的 dataProvider 中的项目。 | IRepeater | ||
dataProvider : Object
此 Repeater 创建其子项的重复实例时使用的数据提供程序。 | IRepeater | ||
recycleChildren : Boolean
布尔值标志,指示此 Repeater 是重用以前创建的子项还是创建新子项。 | IRepeater | ||
startingIndex : int
dataProvider 中的索引,此 Repeater 从此索引位置开始创建子项。 | IRepeater |
方法 | 由以下参数定义 | ||
---|---|---|---|
对此 Repeater 创建的所有 UIComponent 执行绑定。 | IRepeater | ||
初始化新的 Repeater 对象。 | IRepeater |
container | 属性 |
container:IContainer
[只读] 语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
包含此 Repeater 的容器,此 Repeater 将在该容器中创建其子项。
实现
public function get container():IContainer
count | 属性 |
currentIndex | 属性 |
currentIndex:int
[只读] 语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
Repeater 执行时,当前正在处理的 dataProvider
中项目的索引。
Repeater 完成执行后,此属性为 -1
。不过,重复组件实例的 repeaterIndex
属性会记住作为其创建基础的 dataProvider
项目的索引。如果是嵌套的 Repeater,您可以使用 repeaterIndices
数组。
实现
public function get currentIndex():int
相关 API 元素
currentItem | 属性 |
dataProvider | 属性 |
dataProvider:Object
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
此 Repeater 创建其子项的重复实例时使用的数据提供程序。
如果读取 dataProvider
属性,将始终获得 ICollectionView 对象或 null
。如果您将 dataProvider
属性设置为 null
之外的任何值,则将根据以下规则转换为 ICollectionView 对象:
- 如果设置为 Array,则转换为 ArrayCollection。
- 如果设置为 ICollectionView,则不执行任何转换。
- 如果设置为 IList,则转换为 ListCollectionView。
- 如果设置为 XML 或 XMLList,则转换为 XMLListCollection。
- 在其他情况下,转换为单一元素 ArrayCollection。
必须为 dataProvider
属性指定值,否则 Repeater 组件不会执行。
实现
public function get dataProvider():Object
public function set dataProvider(value:Object):void
recycleChildren | 属性 |
recycleChildren:Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
布尔值标志,指示此 Repeater 是重用以前创建的子项还是创建新子项。
如果为 true
,则当此 Repeater 的 dataProvider
、startingIndex
或 count
更改时,它会通过将新数据绑定到现有子项循环使用现有子项。如果需要增加子项,则不断创建和添加子项。如果需要减少子项,则删除多余子项并将其作为垃圾回收。
如果为 false
,则当此 Repeater 的 dataProvider
、startingIndex
或 count
更改时,它将删除以前创建的所有子项,并基于新的数据项创建和添加新子项。
默认情况下,此属性为 false
。将其设置为 true
可提高性能,但并不适用于所有情况。例如,如果以前创建的子项包含状态信息,如用户键入的文本,则循环使用子项时不会重置此状态。
实现
public function get recycleChildren():Boolean
public function set recycleChildren(value:Boolean):void
startingIndex | 属性 |
executeChildBindings | () | 方法 |
public function executeChildBindings():void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
对此 Repeater 创建的所有 UIComponent 执行绑定。
此方法由 Flex 框架调用。开发人员不应调用它。
initializeRepeater | () | 方法 |
public function initializeRepeater(container:IContainer, recurse:Boolean):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
初始化新的 Repeater 对象。
此方法由 Flex 框架调用。开发人员不应调用它。
参数
container:IContainer — 包含此 Repeater 的容器,此 Repeater 将在该容器中创建其子项。
| |
recurse:Boolean — 布尔值标志,指示此 Repeater 是否应创建其子项的所有后代的。
|
Tue Jun 12 2018, 11:04 AM Z