| 包 | mx.core |
| 接口 | public interface IVisualElementContainer |
| 实现器 | Container, ContainerMovieClip, Group, Scroller, SkinnableContainer |
| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
请注意，Spark SkinnableDataContainer 与 DataGroup 容器不会实现该接口。这些容器通过 dataProvider 属性管理子项。
相关 API 元素
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
| numElements : int [只读]
此容器中的可视元素的数量。 | IVisualElementContainer | ||
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
将可视元素添加到此容器中。 | IVisualElementContainer | ||
将可视元素添加到此容器中。 | IVisualElementContainer | ||
返回指定索引处的可视元素。 | IVisualElementContainer | ||
返回可视元素的索引位置。 | IVisualElementContainer | ||
从容器中删除所有可视元素。 | IVisualElementContainer | ||
从此容器的子列表中删除指定的可视元素。 | IVisualElementContainer | ||
从容器中的指定索引位置删除可视元素。 | IVisualElementContainer | ||
在可视容器中更改现有可视元素的位置。 | IVisualElementContainer | ||
交换两个指定可视元素的索引。 | IVisualElementContainer | ||
交换容器中位于两个指定索引位置的可视元素。 | IVisualElementContainer | ||
numElements | 属性 |
addElement | () | 方法 |
public function addElement(element:IVisualElement):IVisualElement| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
将可视元素添加到此容器中。该元素将在添加完所有其他元素之后添加，并出现于所有其他元素之上。要将可视元素添加到特定索引位置，请使用 addElementAt() 方法。
如果添加的可视元素已有一个不同的容器作为父项，则该元素将会从其他容器中删除。
参数
element:IVisualElement — 要添加为此容器的子项的可视元素。
|
IVisualElement — 已添加的元素。
|
事件
elementAdd: — 将元素添加到子列表时调度。
|
引发
ArgumentError — 如果该元素与可视容器相同。
|
addElementAt | () | 方法 |
public function addElementAt(element:IVisualElement, index:int):IVisualElement| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
将可视元素添加到此容器中。该元素将被添加到指定的索引位置。索引 0 代表显示列表中的第一个元素。
如果添加的可视元素已有一个不同的容器作为父项，则该元素将会从其他容器中删除。
参数
element:IVisualElement — 要添加为此可视容器的子项的元素。
| |
index:int — 将该元素添加到的索引位置。如果指定当前占用的索引位置，则该位置以及所有更高位置上的子对象会在子级列表中上移一个位置。
|
IVisualElement — 已添加的元素。
|
事件
elementAdd: — 将元素添加到子列表时调度。
|
引发
ArgumentError — 如果该元素与容器相同。
| |
RangeError — 如果在子列表中不存在该索引位置。
|
getElementAt | () | 方法 |
public function getElementAt(index:int):IVisualElement| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回指定索引处的可视元素。
参数
index:int — 要检索的元素的索引。
|
IVisualElement — 位于指定索引位置的元素。
|
引发
RangeError — 如果在子列表中不存在该索引位置。
|
getElementIndex | () | 方法 |
public function getElementIndex(element:IVisualElement):int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回可视元素的索引位置。
参数
element:IVisualElement — 可视元素。
|
int — 容器中元素的索引位置。
|
引发
ArgumentError — 如果元素不是此可视容器的子项。
|
removeAllElements | () | 方法 |
public function removeAllElements():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
从容器中删除所有可视元素。
removeElement | () | 方法 |
public function removeElement(element:IVisualElement):IVisualElement| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
从此容器的子列表中删除指定的可视元素。在该可视容器中，位于该元素之上的所有元素的索引位置都减少 1。
参数
element:IVisualElement — 要从容器中删除的元素。
|
IVisualElement — 已删除的元素。
|
引发
ArgumentError — 如果元素参数不是此可视容器的子项。
|
removeElementAt | () | 方法 |
public function removeElementAt(index:int):IVisualElement| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
从容器中的指定索引位置删除可视元素。在该可视容器中，位于该元素之上的所有元素的索引位置都减少 1。
参数
index:int — 要删除的元素的索引。
|
IVisualElement — 已删除的元素。
|
引发
RangeError — 如果在子列表中不存在该索引。
|
setElementIndex | () | 方法 |
public function setElementIndex(element:IVisualElement, index:int):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
在可视容器中更改现有可视元素的位置。
在调用 setElementIndex() 方法并指定一个已经占用的索引位置时，只有元素的先前位置和新位置之间的位置发生更改。其他位置保持不变。
如果将某个可视元素移动到低于其当前索引位置的某个索引位置，则在这两个索引之间的所有元素的索引都增加 1。如果将某个元素移动到高于其当前索引位置的某个索引位置，则在这两个索引之间的所有元素的索引都减少 1。
参数
element:IVisualElement — 要为其更改索引编号的元素。
| |
index:int — 元素的最终索引编号。
|
引发
RangeError — 如果在子列表中不存在该索引。
| |
ArgumentError — 如果元素参数不是此可视容器的子项。
|
swapElements | () | 方法 |
public function swapElements(element1:IVisualElement, element2:IVisualElement):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
交换两个指定可视元素的索引。所有其他元素仍位于相同的索引位置。
参数
element1:IVisualElement — 第一个可视元素。
| |
element2:IVisualElement — 第二个可视元素。
|
swapElementsAt | () | 方法 |
Tue Jun 12 2018, 11:04 AM Z