Пакет | mx.core |
Интерфейс | public interface IChildList |
Средство реализации | Container, SystemManager, UIComponent |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Например, рассмотрим класс Container. Он переопределяется API DisplayObjectContainer, например методы numChildren
и getChildAt()
для доступа только к нижестоящим элементам «содержимого», то есть к элементам управления и другим контейнерам, помещенным внутри них. Объект Container также может иметь дополнительные нижестоящие элементы, созданные в инфраструктуре автоматически, например тема оформления фона или границ, и полосы прокрутки. Таким образом, объект Container предоставляет свойство с именем rawChildren
типа IChildList, которое позволяет обращаться ко всем нижестоящим элементам, а не только к элементам содержимого.
Приведем другой пример. Класс SystemManager является объектом DisplayObjectContainer, нижестоящие элементы которого разделены на несколько слоев: обычные нижестоящие элемента (например, объекты Application) находятся внизу, выше находятся всплывающие окна, подсказки и курсоры. Класс SystemManager имеет свойства popUpChildren
, toolTipChildren
и cursorChildren
, которые позволяют обращаться к этим слоям, а типом всех этих свойств является IChildList. Поэтому количество всплывающих окон можно подсчитать с помощью свойства systemManager.popUpChildren.numChildren
, а вставка DisplayObject в слой всплывающих подсказок осуществляется с помощью метода systemManager.toolTipChildren.addChild()
и т. д.
Связанные элементы API
mx.managers.SystemManager.rawChildren
mx.managers.SystemManager.popUpChildren
mx.managers.SystemManager.toolTipChildren
mx.managers.SystemManager.cursorChildren
Свойство | Определено | ||
---|---|---|---|
numChildren : int [только для чтения]
Число нижестоящих элементов в этом списке. | IChildList |
Метод | Определено | ||
---|---|---|---|
Добавляет нижестоящий элемент DisplayObject в конец этого списка нижестоящих элементов. | IChildList | ||
Добавляет нижестоящий объект DisplayObject к нижестоящему списку в указанной позиции индекса. | IChildList | ||
Определяет, находится ли объект DisplayObject в этом нижестоящем списке или является потомком нижестоящего элемента в этом списке. | IChildList | ||
Получает нижестоящий элемент DisplayObject в указанной позиции индекса из этого списка нижестоящих элементов. | IChildList | ||
Получает нижестоящий элемент DisplayObject с определенным именем из этого списка нижестоящих элементов. | IChildList | ||
Получает индекс определенного нижестоящего элемента из списка нижестоящих элементов. | IChildList | ||
Возвращает массив объектов DisplayObjects, расположенных ниже заданной позиции и находящихся в списке нижестоящих элементов. | IChildList | ||
Удаляет указанный нижестоящий элемент DisplayObject из этого списка нижестоящих элементов. | IChildList | ||
Удаляет нижестоящий элемент DisplayObject в указанной позиции индекса из этого списка нижестоящих элементов. | IChildList | ||
Изменяет индекс определенного нижестоящего элемента в этом списке. | IChildList |
numChildren | свойство |
addChild | () | метод |
public function addChild(child:DisplayObject):DisplayObject
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Добавляет нижестоящий элемент DisplayObject в конец этого списка нижестоящих элементов.
Вызов childList.addChild(child)
аналогичен вызову childList.addChild(child, childList.numChildren)
После добавления индекс нового нижестоящего элемента будет равен (child.numChildren – 1)
Параметры
child:DisplayObject — Элемент DisplayObject, добавляемый в качестве нижестоящего элемента.
|
DisplayObject — Добавленный нижестоящий элемент аналогичен переданному аргументу.
|
addChildAt | () | метод |
public function addChildAt(child:DisplayObject, index:int):DisplayObject
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Добавляет нижестоящий объект DisplayObject к нижестоящему списку в указанной позиции индекса. Индекс 0 соответствует началу DisplayList, а индекс numChildren
соответствует его концу.
Добавление нижестоящего элемента в любое положение, за исключением конца списка нижестоящих элементов, увеличивает индексы нижестоящих элементов, которые имели более высокие индексы или имели этот индекс.
Параметры
child:DisplayObject — Элемент DisplayObject, добавляемый в качестве нижестоящего элемента.
| |
index:int — Индекс для места добавления нижестоящего элемента.
|
DisplayObject — Добавленный нижестоящий элемент аналогичен переданному аргументу child .
|
contains | () | метод |
public function contains(child:DisplayObject):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет, находится ли объект DisplayObject в этом нижестоящем списке или является потомком нижестоящего элемента в этом списке.
Параметры
child:DisplayObject — Тестируемый DisplayObject.
|
Boolean — true , если DisplayObject находится в этом нижестоящем списке или является потомком нижестоящего элемента в этом списке. В противном случае значение равно false .
|
getChildAt | () | метод |
public function getChildAt(index:int):DisplayObject
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Получает нижестоящий элемент DisplayObject в указанной позиции индекса из этого списка нижестоящих элементов.
Параметры
index:int — Целое число от 0 до (numChildren - 1) , указывающее индекс нижестоящего элемента в этом списке.
|
DisplayObject — Нижестоящий элемент с указанным индексом.
|
getChildByName | () | метод |
public function getChildByName(name:String):DisplayObject
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Получает нижестоящий элемент DisplayObject с определенным именем из этого списка нижестоящих элементов.
Параметры
name:String — Имя возвращаемого нижестоящего элемента.
|
DisplayObject — Нижестоящий элемент с указанным именем.
|
getChildIndex | () | метод |
public function getChildIndex(child:DisplayObject):int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Получает индекс определенного нижестоящего элемента из списка нижестоящих элементов.
Первый нижестоящий элемент в списке имеет индекс 0, второй элемент – индекс 1, а последний элемент – индекс (numChildren - 1)
.
Если getChildIndex(myChild)
возвращает 5, то myView.getChildAt(5)
возвращает myChild
.
При добавлении нижестоящего элемента путем вызова метода addChild()
индекс нового элемента равен наибольшему существующему индексу, увеличенному на единицу.
Нижестоящий элемент можно добавить с определенным индексом с помощью метода addChildAt()
. В этом случае для нижестоящих элементов, которые ранее имели этот индекс и более высокие индексы, индекс увеличивается на 1 для индексации элементов от 0 до (numChildren - 1)
.
При удалении нижестоящего элемента путем вызова методов removeChild()
и removeChildAt()
индекс остальных элементов уменьшается на 1, чтобы обеспечить индексацию элементов от 0 до (numChildren - 1)
.
При изменении индекса нижестоящего элемента с помощью метода setChildIndex()
индексы элементов, расположенных между старым и новым индексом включительно, корректируются таким образом, чтобы сохранить индексацию всех элементов от 0 до (numChildren - 1)
.
Параметры
child:DisplayObject — Нижестоящий элемент, индекс которого необходимо получить.
|
int — Индекс нижестоящего элемента, равный целому числу между 0 и (numChildren - 1) .
|
getObjectsUnderPoint | () | метод |
public function getObjectsUnderPoint(point:Point):Array
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает массив объектов DisplayObjects, расположенных ниже заданной позиции и находящихся в списке нижестоящих элементов.
Параметры
point:Point — Точка, под которой следует выполнить поиск.
|
Array — Массив объектов, расположенных ниже заданной позиции и являющихся нижестоящими объектами этого контейнера.
|
removeChild | () | метод |
public function removeChild(child:DisplayObject):DisplayObject
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удаляет указанный нижестоящий элемент DisplayObject из этого списка нижестоящих элементов.
Удаление нижестоящего элемента из любого положения, за исключением конца списка нижестоящих элементов, уменьшает индексы нижестоящих элементов, которые имели более высокие индексы.
Вышестоящий элемент удаленного нижестоящего элемента будет иметь значение null и будет собран сборщиком мусора, если на него не существует других ссылок.
Параметры
child:DisplayObject — Удаляемый элемент DisplayObject.
|
DisplayObject — Удаленный нижестоящий элемент аналогичен переданному аргументу.
|
removeChildAt | () | метод |
public function removeChildAt(index:int):DisplayObject
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удаляет нижестоящий элемент DisplayObject в указанной позиции индекса из этого списка нижестоящих элементов.
Удаление нижестоящего элемента из любого положения, за исключением конца списка нижестоящих элементов, уменьшает индексы нижестоящих элементов, которые имели более высокие индексы.
Вышестоящий элемент удаленного нижестоящего элемента будет иметь значение null и будет собран сборщиком мусора, если на него не существует других ссылок.
Параметры
index:int — Удаляемый индекс нижестоящего элемента DisplayObject.
|
DisplayObject — Удаленный нижестоящий элемент.
|
setChildIndex | () | метод |
public function setChildIndex(child:DisplayObject, newIndex:int):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Изменяет индекс определенного нижестоящего элемента в этом списке. См. описание метода getChildIndex()
для получения описания индекса нижестоящего элемента.
Параметры
child:DisplayObject — Нижестоящий элемент, для которого выполняется изменение индекса.
| |
newIndex:int — Новый индекс для указанного нижестоящего элемента. Индекс должен быть целым числом в диапазоне между 0 и (numChildren - 1) .
|
Tue Jun 12 2018, 11:34 AM Z