| Пакет | mx.states |
| Класс | public class AddChild |
| Наследование | AddChild  OverrideBase OnDemandEventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
overrides класса State. Свойство creationPolicy используется для определения необходимости создания нижестоящего элемента при запуске приложения или же во время изменения состояния представления.
Нижестоящий элемент не отправляет событие creationComplete до добавления управляющего элемента к контейнеру. Например, следующий код добавляет элемент управления Button в качестве составной части изменения состояния представления:
<mx:AddChild relativeTo="{v1}">
<mx:Button id="b0" label="New Button"/>
</mx:AddChild>
В предыдущем примере элемент управления Button не отправляет событие creationComplete до изменения состояния и добавления элемента управления Button к контейнеру. Если класс AddChild определяет и элемент управления Button, и контейнер (например, контейнер Canvas), то элемент управления Button отправляет событие creationComplete при его создании. Например, если для свойства creationPolicy устанавливается значение all, элемент управления Button отправляет это событие при запуске приложения. Если для свойства creationPolicy устанавливается значение auto, элемент управления Button отправляет событие при изменении состояния представления.
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <mx:AddChild> tag
has the following attributes:
<mx:AddChild Properties target="null" targetFactory="null" creationPolicy="auto" position="lastChild" relativeTo="parent of the State object" />
Свойство MXML по умолчаниюtargetFactory
Связанные элементы API
| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| creationPolicy : String
Политика создания этого нижестоящего элемента. | AddChild | ||
| position : String
Позиция нижестоящего элемента в списке отображения относительно объекта, указанного свойством relativeTo. | AddChild | ||
| relativeTo : Object
Объект, нижестоящий элемент которого добавляется. | AddChild | ||
| target : DisplayObject
Добавляемый нижестоящий элемент. | AddChild | ||
| targetFactory : IDeferredInstance
Фабрика, которая создает нижестоящий элемент. | AddChild | ||
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | AddChild | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | OnDemandEventDispatcher | |
[переопределить]
Применяет переопределение. | AddChild | ||
Создает нижестоящий экземпляр из фабрики. | AddChild | ||
|
Посылает событие в поток событий. | OnDemandEventDispatcher | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | OnDemandEventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
[переопределить]
Метод интерфейса IOverride; этот класс реализует его как пустой метод. | AddChild | ||
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
[переопределить]
Удаляет переопределение. | AddChild | ||
|
Удаляет прослушиватель из объекта EventDispatcher. | OnDemandEventDispatcher | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | OnDemandEventDispatcher | |
creationPolicy | свойство |
creationPolicy:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Политика создания этого нижестоящего элемента. Эти свойства определяют момент создания targetFactory экземпляра нижестоящего элемента. Flex использует этот свойство только в том случае, если определено свойство targetFactory. Допустимыми являются следующие значения:
| Значение | Значение |
|---|---|
auto | (задано по умолчанию) Экземпляр создается при его первом использовании. |
all | Экземпляр создается при запуске приложения. |
не задано | Экземпляр автоматически не создается. Для создания этого экземпляра следует вызвать метод createInstance(). |
Значением по умолчанию является "auto".
Реализация
public function get creationPolicy():String public function set creationPolicy(value:String):voidposition | свойство |
public var position:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Позиция нижестоящего элемента в списке отображения относительно объекта, указанного свойством relativeTo. Допустимыми значениями являются: before, after, firstChild и lastChild.
Значением по умолчанию является "lastChild".
relativeTo | свойство |
public var relativeTo:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Объект, нижестоящий элемент которого добавляется. Это свойство используется вместе со свойством position. Эти свойства являются необязательными; если они опущены, Flex использует непосредственный вышестоящий элемент объекта State, т. е. компонент, имеющий свойство states, или тег <mx:states>, который определяет объект State.
target | свойство |
target:DisplayObject| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Добавляемый нижестоящий элемент. В случае установки этого свойства нижестоящий экземпляр создается при запуске приложения. Установка этого свойства эквивалентна установке свойства targetFactory с creationPolicy, имеющим значение all.
Не устанавливайте это свойство, если определено свойство targetFactory.
Реализация
public function get target():DisplayObject public function set target(value:DisplayObject):voidtargetFactory | свойство |
targetFactory:IDeferredInstance| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Фабрика, которая создает нижестоящий элемент. Можно указать любой из следующих элементов:
- Заводской класс, который реализует интерфейс IDeferredInstance и создает нижестоящий экземпляр или экземпляры.
- Компонент Flex (т. е. любой класс, являющийся подклассом класса UIComponent), например элемент управления Button. Если используется компонент Flex, компилятор Flex автоматически вставляет компонент в заводской класс.
При установке этого свойства экземпляр нижестоящего элемента создается в момент времени, определяемый свойством creationPolicy.
Не устанавливайте это свойство, если определено свойство target. Это свойство является свойством по умолчанию класса AddChild. Установка этого свойства с creationPolicy, имеющим значение all, эквивалентна установке свойства target.
Реализация
public function get targetFactory():IDeferredInstance public function set targetFactory(value:IDeferredInstance):voidAddChild | () | Конструктор |
public function AddChild(relativeTo:UIComponent = null, target:DisplayObject = null, position:String = "lastChild")| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор.
ПараметрыrelativeTo:UIComponent (default = null) | |
target:DisplayObject (default = null) | |
position:String (default = "lastChild")target относительно компонента relativeTo. Это свойство должно принимать одно из следующих значений: firstChild, lastChild, before или after.
|
apply | () | метод |
override public function apply(parent:UIComponent):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Применяет переопределение. Flex сохраняет первоначальное значение для обеспечения последующей возможности восстановления значения в методе remove().
Этот метод вызывается автоматически при вводе состояния. Выполнять вызов метода напрямую не требуется.
Параметры
parent:UIComponent — Вышестоящий элемент объекта State, содержащего это переопределение. Переопределение должно использовать его в качестве целевого объекта, если таковой явно не указан.
|
createInstance | () | метод |
public function createInstance():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Создает нижестоящий экземпляр из фабрики. Этот метод следует использовать только в том случае, если задается свойство targetFactory, а creationPolicy имеет значение none. Flex автоматически вызывает этот метод, если свойство creationPolicy имеет значение auto или all. Если этот метод вызывается несколько раз, нижестоящий экземпляр создается только при первом вызове.
initialize | () | метод |
override public function initialize():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Метод интерфейса IOverride; этот класс реализует его как пустой метод.
remove | () | метод |
override public function remove(parent:UIComponent):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удаляет переопределение. Восстанавливается значение, сохраненное в методе apply().
Этот метод вызывается автоматически при вводе состояния. Выполнять вызов метода напрямую не требуется.
Параметры
parent:UIComponent — Вышестоящий элемент объекта State, содержащего это переопределение. Переопределение должно использовать его в качестве целевого объекта, если таковой явно не указан.
|
Tue Jun 12 2018, 11:34 AM Z