| 包 | 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():IContainercount | 属性 |
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):voidrecycleChildren | 属性 |
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):voidstartingIndex | 属性 |
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