DynamicManagedItem

Пакет	mx.data
Класс	public dynamic class DynamicManagedItem
Наследование	DynamicManagedItem Proxy
Реализует	IManaged

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3.1

Версии среды выполнения:

Flash Player 9, AIR 1.1

Типизированный управляемый элемент, который является динамическим, должен расширять этот класс, чтобы при изменении динамических свойств изменялись выполняемые события.

Общедоступные методы

	Метод		Определено
		DynamicManagedItem() Конструктор.	DynamicManagedItem
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, weakRef:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	DynamicManagedItem
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	DynamicManagedItem
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	DynamicManagedItem
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	DynamicManagedItem
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	DynamicManagedItem

Защищенные методы

	Метод		Определено
		callProperty(name:, ... parameters): [переопределить] Переопределяет поведение свойства объекта, которое может быть вызвано как функция.	DynamicManagedItem
		deleteProperty(name:*):Boolean [переопределить] Переопределяет запрос на удаление свойства.	DynamicManagedItem
		getProperty(name:): [переопределить] Переопределяет любой запрос значения свойства.	DynamicManagedItem
		hasProperty(name:*):Boolean [переопределить] Переопределяет запрос на проверку наличия у объекта конкретного свойства по имени.	DynamicManagedItem
		nextName(index:int):String [переопределить] Разрешает перечисление свойств объекта с прокси по номеру позиции индекса для получения имен свойств.	DynamicManagedItem
		nextNameIndex(index:int):int [переопределить] Разрешает перечисление свойств объекта с прокси по номеру позиции индекса.	DynamicManagedItem
		nextValue(index:int):* [переопределить] Разрешает перечисление свойств объекта с прокси по номеру позиции индекса для получения значений свойств.	DynamicManagedItem
		setProperty(name:, value:):void [переопределить] Переопределяет вызов для изменения значения свойства.	DynamicManagedItem

Сведения о конструкторе

()

Конструктор

public function DynamicManagedItem()

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3.1

Версии среды выполнения:

Flash Player 9, AIR 1.1

Конструктор.

Сведения о методе

addEventListener

()

метод

 public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, weakRef:Boolean = false):void

Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. Можно регистрировать прослушиватели событий в любом узле из списка отображения для каждого типа события, фазы и приоритета.

После успешной регистрации прослушивателя событий невозможно изменить его приоритет путем дополнительных вызовов addEventListener(). Для изменения приоритета прослушивателя следует вначале вызвать removeEventListener(). Затем можно снова зарегистрировать прослушиватель с новым приоритетом.

После регистрации прослушивателя последующие вызовы addEventListener() со значениями, отличающимися от type и useCapture приводят к его отдельной регистрации. Например, прослушиватель, изначально зарегистрированный со значением useCapture, равным true, прослушивает только во время фазы захвата. После повторного вызова addEventListener() с помощью аналогичного объекта прослушивания, но со значением useCapture, равным false, активными становятся два отдельных прослушивателя: один прослушивает во время фазы захвата, второй – во время целевой фазы и фазы восходящей цепочки.

Невозможно зарегистрировать прослушиватель события только для целевой фазы или для фазы восходящей цепочки. Эти фазы соединены при регистрации, поскольку восходящая цепочка применяется только к предшественникам целевого узла.

При отсутствии необходимости в прослушивателе события он может быть удален с помощью вызова EventDispatcher.removeEventListener(); в противном случае могут возникнуть проблемы с памятью. Объекты с зарегистрированными прослушивателями события автоматически не удаляются из памяти, поскольку сборщик мусора не удаляет объекты, на которые имеются ссылки.

Копирование экземпляра EventDispatcher не приводит к копированию прослушивателей событий, присоединенных к нему. (Если для вновь создаваемого узла требуется прослушиватель событий, его необходимо присоединить после создания узла.) При этом при перемещении экземпляра EventDispatcher присоединенные к нему прослушиватели событий перемещаются вместе с ним.

Прослушиватель событий, регистрируемый на узле, на котором в это время обрабатывается событие, не запускается в ходе текущей фазы, но может быть запущен в потоке событий более поздней фазы, например фазы восходящей цепочки.

Прослушиватель событий, удаленный из узла во время обработки события на этом узле, будет запускаться текущими операциями. После удаления прослушиватель событий никогда не вызывается повторно (если только он не был повторно зарегистрирован для будущей обработки).

Параметры

	`type:String` — Тип события.

	`listener:Function` — Функция прослушивателя, обрабатывающая событие. Эта функция принимает объект события как единственный параметр и ничего не возвращает, например: `function(evt:Event):void` Эта функция может иметь любое имя.

	`useCapture:Boolean` (default = `false`) — Определяет, работает ли прослушиватель в фазе захвата или в целевой фазе и в фазе восходящей цепочки. Если значение `useCapture` равно `true`, прослушиватель обрабатывает событие только во время фазы захвата, но не во время целевой фазы или фазы восходящей цепочки. Если значение `useCapture` равно `false`, то прослушиватель обрабатывает событие только в целевой фазе или фазе восходящей цепочки. Для прослушивания события во всех трех фазах следует дважды вызвать `addEventListener()`, первый раз с `useCapture`, равным `true`, а второй раз с `useCapture`, равным `false`.

	`priority:int` (default = `0`) — Уровень приоритета прослушивателя событий. Приоритеты обозначены 32-разрядным целым числом. Чем больше число, тем выше приоритет. Все прослушиватели с приоритетом n обрабатываются перед обработкой прослушивателей с приоритетом n-1. Прослушиватели с одинаковым приоритетом обрабатываются в порядке их добавления. Значение приоритета по умолчанию равно 0.

	`weakRef:Boolean` (default = `false`) — Определяет, является ли ссылка на прослушиватель «сильной» или «слабой». «Сильная» ссылка (по умолчанию) предотвращает удаление прослушивателя сборщиком мусора. «Слабая» ссылка позволяет удалить прослушиватель. Функции элементов уровня класса не подлежат удалению в качестве мусора, вследствие чего можно установить `useWeakReference` равным `true` для функций элементов уровня класса, не подвергая их возможности подобного удаления. Если значение `useWeakReference` равно `true` для прослушивателя, являющегося вложенной внутренней функцией, такая функция может быть удалена в качестве мусора и перестанет быть устойчивой. При создании ссылок на внутреннюю функцию (возможно сохранение в другой переменной) она не будет собираться в качестве мусора и останется устойчивой.

callProperty

()

метод

override flash_proxy function callProperty(name:*, ... parameters):*

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3.1

Версии среды выполнения:

Flash Player 9, AIR 1.1

Переопределяет поведение свойства объекта, которое может быть вызвано как функция. Этот метод вызывается при вызове методов объектов. Некоторые объекты можно вызывать как функции. Некоторые свойства объекта также можно вызывать как функции.

Параметры

	`name:*` — Имя вызываемого метода.

	`... parameters` — Массив аргументов вызываемого метода.

Возвращает

* — Значение, которое возвращает вызываемый метод.

deleteProperty

()

метод

override flash_proxy function deleteProperty(name:*):Boolean

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3.1

Версии среды выполнения:

Flash Player 9, AIR 1.1

Переопределяет запрос на удаление свойства. Когда свойство удаляется с помощью оператора delete, для удаления вызывается этот метод.

Параметры

name:* — Имя удаляемого свойства

Возвращает

Boolean — Если свойство удалено, указывается значение true; в противном случае выбирается значение false.

dispatchEvent

()

метод

public function dispatchEvent(event:Event):Boolean

Посылает событие в поток событий. Адресатом события является объект EventDispatcher, в котором вызывается dispatchEvent().

Параметры

event:Event — Объект события, переданный в поток событий.

Возвращает

Boolean — Значение равно true до тех пор, пока preventDefault() не будет вызван для события; в этом случае возвращается значение false.

getProperty

()

метод

override flash_proxy function getProperty(name:*):*

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3.1

Версии среды выполнения:

Flash Player 9, AIR 1.1

Переопределяет любой запрос значения свойства. Если свойство не удается найти, метод возвращает значение undefined. Дополнительные сведения об этом поведении см. в спецификации языка ECMA-262, 3-е издание, раздел 8.6.2.1.

Параметры

name:* — Имя получаемого свойства

Возвращает

* — Указанное свойство или undefined, если свойство не найдено.

hasEventListener

()

метод

public function hasEventListener(type:String):Boolean

Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. Это позволяет определить, где объект EventDispatcher изменил обработку типа события в иерархии потока событий. Для определения, действительно ли определенный тип события запускает прослушиватель события, следует использовать IEventDispatcher.willTrigger().

Различие между hasEventListener() и willTrigger() заключается в том, что hasEventListener() анализирует только объект, к которому он принадлежит, тогда как willTrigger() — весь поток событий для события, указанного параметром type.

Параметры

type:String — Тип события.

Возвращает

Boolean — Значение true, если прослушиватель указанного типа зарегистрирован; в противном случае – false.

hasProperty

()

метод

override flash_proxy function hasProperty(name:*):Boolean

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3.1

Версии среды выполнения:

Flash Player 9, AIR 1.1

Переопределяет запрос на проверку наличия у объекта конкретного свойства по имени.

Параметры

name:* — Имя проверяемого свойства.

Возвращает

Boolean — Если свойство существует, указывается значение true; в противном случае выбирается значение false.

nextName

()

метод

override flash_proxy function nextName(index:int):String

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3.1

Версии среды выполнения:

Flash Player 9, AIR 1.1

Разрешает перечисление свойств объекта с прокси по номеру позиции индекса для получения имен свойств. При этом свойства самого класса Proxy перечислять нельзя. Эта функция поддерживает реализацию циклов for...in и for each.in в объекте для получения нужных имен.

Параметры

index:int — Отсчитываемое от нуля значение индекса для свойства объекта.

Возвращает

String — Имя свойства.

nextNameIndex

()

метод

override flash_proxy function nextNameIndex(index:int):int

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3.1

Версии среды выполнения:

Flash Player 9, AIR 1.1

Разрешает перечисление свойств объекта с прокси по номеру позиции индекса. При этом свойства самого класса Proxy перечислять нельзя. Эта функция поддерживает реализацию циклов for...in и for each.in в объекте для получения значений индекса свойства.

Параметры

index:int — Отсчитываемое от нуля значение индекса, с которого начинается перечисление.

Возвращает

int — Значение индекса свойства.

nextValue

()

метод

override flash_proxy function nextValue(index:int):*

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3.1

Версии среды выполнения:

Flash Player 9, AIR 1.1

Разрешает перечисление свойств объекта с прокси по номеру позиции индекса для получения значений свойств. При этом свойства самого класса Proxy перечислять нельзя. Эта функция поддерживает реализацию циклов for...in и for each.in в объекте для получения нужных значений.

Параметры

index:int — Отсчитываемое от нуля значение индекса для свойства объекта.

Возвращает

* — Значение свойства.

removeEventListener

()

метод

public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void

Удаляет прослушиватель из объекта EventDispatcher. При отсутствии прослушивателя, зарегистрированного с объектом EventDispatcher, вызов этого метода не оказывает эффекта.

Параметры

	`type:String` — Тип события.

	`listener:Function` — Удаляемый объект прослушивателя.

	`useCapture:Boolean` (default = `false`) — Указывает, был ли слушатель зарегистрирован для фазы захвата или целевой фазы и фазы восходящей цепочки. Если прослушиватель был зарегистрирован для фазы захвата, целевой фазы и фазы восходящей цепочки, необходимо удалить оба вызова `removeEventListener()`: один вызов с `useCapture`, равным `true`, и второй вызов с `useCapture`, равным `false`.

setProperty

()

метод

override flash_proxy function setProperty(name:*, value:*):void

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3.1

Версии среды выполнения:

Flash Player 9, AIR 1.1

Переопределяет вызов для изменения значения свойства. Если свойство не удается найти, этот метод создает свойство с указанным именем и значением.

Параметры

	`name:*` — Имя модифицируемого свойства

	`value:*` — Значение, которое присваивается свойству.

willTrigger

()

метод

public function willTrigger(type:String):Boolean

Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. Этот метод возвращает значение true, если прослушиватель события запускается в течение любой фазы потока событий, когда событие указанного типа передается объекту EventDispatcher или любому из его нижестоящих элементов.

Параметры

type:String — Тип события.

Возвращает

Boolean — Значение равно true при запуске прослушивателя указанного типа; в противном случае значение равно false.

Юридическая информация | Политика конфиденциальности онлайн

DynamicManagedItem - AS3 ADEP Data Services

Классы x