| Пакет | 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 | свойство |
numElements:int [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Количество визуальных элементов в данном контейнере. Визуальные элементы включают в себя классы, которые реализуют интерфейс IVisualElement, например подклассы UIComponent и GraphicElement.
Реализация
public function get numElements():intaddElement | () | метод |
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 | () | метод |
public function swapElementsAt(index1:int, index2:int):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Меняет местами визуальные элементы в двух указанных позициях индекса в контейнере. Позиции индекса остальных визуальных элементов не меняются.
Параметры
index1:int — Индекс первого элемента.
| |
index2:int — Индекс второго элемента.
|
Выдает
RangeError — Если индексы отсутствуют в визуальном контейнере.
|
Tue Jun 12 2018, 11:34 AM Z