CollectionEvent

Пакет	mx.events
Класс	public class CollectionEvent
Наследование	CollectionEvent Event Object

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Класс mx.events.CollectionEvent представляет событие, передаваемое при изменении связанной коллекции.

Связанные элементы API

FlexEvent.CURSOR_UPDATE

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		bubbles : Boolean [только для чтения] Определяет, является ли событие событием восходящей цепочки.	Event
		cancelable : Boolean [только для чтения] Указывает, можно ли предотвратить поведение, связанное с событием.	Event
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		currentTarget : Object [только для чтения] Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.	Event
		eventPhase : uint [только для чтения] Текущая фаза в потоке событий.	Event
		items : Array Если значение kind равно CollectionEventKind.ADD или CollectionEventKind.REMOVE, свойство items представляет собой массив добавленных/удаленных элементов.	CollectionEvent
		kind : String Указывает вид произошедшего события.	CollectionEvent
		location : int Если значение kind равно CollectionEventKind.ADD, CollectionEventKind.MOVE, CollectionEventKind.REMOVE или CollectionEventKind.REPLACE, это свойство представляет собой отсчитываемый от нуля индекс коллекции элементов, указанных в свойстве items.	CollectionEvent
		oldLocation : int Если значение kind равно CollectionEventKind.MOVE, это свойство представляет собой отсчитываемый от нуля индекс в целевой коллекции предыдущего местоположения элементов, указанных свойством items.	CollectionEvent
		target : Object [только для чтения] Целевой объект события.	Event
		type : String [только для чтения] Тип события.	Event

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

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		CollectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, kind:String = null, location:int = -1, oldLocation:int = -1, items:Array = null) Конструктор.	CollectionEvent
		clone():Event Создает дубликат экземпляра подкласса Event.	Event
		formatToString(className:String, ... arguments):String Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event.	Event
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		isDefaultPrevented():Boolean Проверяет, выполнялся ли для события вызова метода preventDefault().	Event
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		preventDefault():void Отменяет поведение по умолчанию для события, если такое поведение можно отменить.	Event
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		stopImmediatePropagation():void Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом.	Event
		stopPropagation():void Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом.	Event
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строку, содержащую все свойства объекта Event.	Event
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object

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

Скрыть унаследованные общедоступные константы

Показать унаследованные общедоступные константы

	Константа		Определено
		COLLECTION_CHANGE : String = "collectionChange" [статические] Константа CollectionEvent.COLLECTION_CHANGE определяет значение свойства type объекта события, передаваемого при изменении коллекции.	CollectionEvent

Сведения о свойстве

items

свойство

public var items:Array

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Если значение kind равно CollectionEventKind.ADD или CollectionEventKind.REMOVE , свойство items представляет собой массив добавленных/удаленных элементов. Если значение kind равно CollectionEventKind.REPLACE или CollectionEventKind.UPDATE, свойство items представляет собой массив объектов PropertyChangeEvent с информацией об элементах, задействованных событием. Если значение изменяется, следует запросить поля newValue и oldValue объектов PropertyChangeEvent для определения старых и новых значений. Если значение kind равно CollectionEventKind.REFRESH или CollectionEventKind.RESET, этот массив имеет нулевую длину.

Значением по умолчанию является [ ].

Связанные элементы API

PropertyChangeEvent

kind

свойство

public var kind:String

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Указывает вид произошедшего события. Значение свойства может быть равно одному из значений класса CollectionEventKind или null, если вид неизвестен.

Значением по умолчанию является null.

Связанные элементы API

CollectionEventKind

location

свойство

public var location:int

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Если значение kind равно CollectionEventKind.ADD, CollectionEventKind.MOVE, CollectionEventKind.REMOVE или CollectionEventKind.REPLACE, это свойство представляет собой отсчитываемый от нуля индекс коллекции элементов, указанных в свойстве items.

Значением по умолчанию является -1.

Связанные элементы API

CollectionEventKind

oldLocation

свойство

public var oldLocation:int

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Если значение kind равно CollectionEventKind.MOVE, это свойство представляет собой отсчитываемый от нуля индекс в целевой коллекции предыдущего местоположения элементов, указанных свойством items.

Значением по умолчанию является -1.

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

()

Конструктор

public function CollectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, kind:String = null, location:int = -1, oldLocation:int = -1, items:Array = null)

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

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

Параметры

	`type:String` — Тип события; указывает действие, инициировавшее событие.

	`bubbles:Boolean` (default = `false`) — Указывает, может ли событие передаваться вверх по иерархии списка отображения.

	`cancelable:Boolean` (default = `false`) — Указывает, существует ли возможность предотвращения поведения, связанного с событием.

	`kind:String` (default = `null`) — Указывает вид произошедшего события. Значение параметра может быть равно одному из значений в классе CollectionEventKind или `null`, если вид неизвестен.

	`location:int` (default = `-1`) — Если значение `kind` равно `CollectionEventKind.ADD`, `CollectionEventKind.MOVE`, `CollectionEventKind.REMOVE` или `CollectionEventKind.REPLACE`, оно указывает, где в целевой коллекции находятся элементы, указанные в свойстве `items`.

	`oldLocation:int` (default = `-1`) — Если значение `kind` равно `CollectionEventKind.MOVE`, оно определяет прежнее местоположение в целевой коллекции элементов, указанных свойством `items`.

	`items:Array` (default = `null`) — Массив объектов с информацией об элементах, задействованных событием, как указано в свойстве `items`. Если значение `kind` равно `CollectionEventKind.REFRESH` или `CollectionEventKind.RESET`, этот массив имеет нулевую длину.

Сведения о константе

COLLECTION_CHANGE

Константа

public static const COLLECTION_CHANGE:String = "collectionChange"

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Константа CollectionEvent.COLLECTION_CHANGE определяет значение свойства type объекта события, передаваемого при изменении коллекции.

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

Свойство	Значение
`bubbles`	false
`cancelable`	false
`currentTarget`	Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется `myButton.addEventListener()` для регистрации прослушивателя события, значением `currentTarget` является myButton.
`items`	Массив объектов с информацией об элементах, задействованных этим событием. Содержимое этого поля зависит от вида события; для получения подробной информации см. описание свойства `items`
`kind`	Вид события. Допустимые значения определены в классе CollectionEventKind как константы.
`location`	Местоположение внутри целевой коллекции элементов, указанное в свойстве `items`.
`oldLocation`	прежнее местоположение элемента в коллекции, указанное в свойстве `items`.
`target`	Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство `currentTarget` всегда используется для получения доступа к объекту, прослушивающему событие.
`type`	CollectionEvent.COLLECTION_CHANGE

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

CollectionEvent - AS3 Flex

Классы x

items

kind

location

oldLocation

CollectionEvent

COLLECTION_CHANGE