Пакет | 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 отправляет событие при изменении состояния представления.
The <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):void
position | свойство |
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):void
targetFactory | свойство |
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):void
AddChild | () | Конструктор |
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 ) — Нижестоящий объект. Все компоненты Flex являются подклассами класса DisplayObject.
| |
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