ArrayList

Пакет	mx.collections
Класс	public class ArrayList
Наследование	ArrayList EventDispatcher Object
Реализует	IList, IExternalizable, IPropertyChangeNotifier
Подклассы	Conflicts

Язык версии:

ActionScript 3.0

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

Flex 4

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

Flash Player 10, AIR 1.5

Класс ArrayList представляет собой простую реализацию IList, которая использует вспомогательный массив в качестве источника данных. Использование и обработка элементов вспомогательного массива осуществляется посредством методов и свойств интерфейса IList. Операции с экземпляром ArrayList изменяют источник данных; например, при использовании метода removeItemAt() в ArrayList элемент удаляется из основного массива. Этот базовый класс не генерирует ItemPendingErrors, однако такие ошибки могут генерироваться подклассом.

  <mx:ArrayList
  Properties
  source="null"
  />

Свойство MXML по умолчаниюsource

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

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

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

	Свойство		Определено
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		length : int [только для чтения] Возвращает количество элементов в списке.	ArrayList
		source : Array Исходный массив для этого ArrayList.	ArrayList
		uid : String Предоставляет доступ к уникальному идентификатору для этого списка.	ArrayList

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

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

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

	Метод		Определено
		ArrayList(source:Array = null) Создание нового ArrayList с помощью указанного массива в качестве источника.	ArrayList
		addAll(addList:IList):void Добавляет список элементов к текущему списку, помещая их в конце списка в порядке передачи.	ArrayList
		addAllAt(addList:IList, index:int):void Добавляет список элементов к текущему списку, помещая их в позиции индекса, передаваемого в функцию.	ArrayList
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		addItem(item:Object):void Добавление указанного элемента в конец списка.	ArrayList
		addItemAt(item:Object, index:int):void Добавление элемента в заданную позицию индекса.	ArrayList
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		getItemAt(index:int, prefetch:int = 0):Object Получение элемента, расположенного в заданной позиции индекса.	ArrayList
		getItemIndex(item:Object):int Возвращает индекс элемента, если он находится в списке, например getItemAt(index) == элемент.	ArrayList
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		itemUpdated(item:Object, property:Object = null, oldValue:Object = null, newValue:Object = null):void Уведомить представление об обновлении элемента.	ArrayList
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeAll():void Удаляет все элементы из списка.	ArrayList
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		removeItem(item:Object):Boolean Удаляет указанный элемент из этого списка (при его наличии).	ArrayList
		removeItemAt(index:int):Object Удаление элемента в указанной позиции индекса и его возврат.	ArrayList
		setItemAt(item:Object, index:int):Object Помещает элемент в заданную позицию индекса.	ArrayList
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		toArray():Array Возвращает массив, заполняемый в порядке, аналогичном реализации IList.	ArrayList
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String [переопределить] Pretty вводит содержимое этого ArrayList в строку и возвращает ее.	ArrayList
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

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

	Метод		Определено
		itemUpdateHandler(event:PropertyChangeEvent):void Вызывается при каждой отправке события ObjectChange любым из элементов в списке.	ArrayList
		startTrackUpdates(item:Object):void Если элемент - IEventDispatcher, следите за его обновлениями.	ArrayList
		stopTrackUpdates(item:Object):void Если элемент – IEventDispatcher, следить за его обновлением не требуется.	ArrayList

События

Дополнительные сведения о событиях

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

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

	Сводка	Определено
activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
collectionChange	Передается при некоторых обновлениях IList.	ArrayList
deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher

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

length

свойство

length:int [только для чтения]

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Возвращает количество элементов в списке. ArrayList должен содержать информацию о его длине, таким образом, не должно возвращаться значение -1, однако такое поведение может быть переопределено подклассом.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие collectionChange .

Реализация
public function get length():int

source

свойство

source:Array

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Исходный массив для этого ArrayList. Любые изменения, внесенные посредством интерфейса IList, будут отражены в исходном массиве. Если исходный массив не предоставлен, ArrayList создает этот массив на внутреннем уровне. Изменения, внесенные непосредственно в основной массив (например, вызов метода theList.source.pop()), не повлекут за собой диспетчеризацию CollectionEvents.

Реализация
public function get source():Array
public function set source(value:Array):void

uid

свойство

uid:String

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Предоставляет доступ к уникальному идентификатору для этого списка.

Реализация
public function get uid():String
public function set uid(value:String):void

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

()

Конструктор

public function ArrayList(source:Array = null)

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Создание нового ArrayList с помощью указанного массива в качестве источника. Если источник не указан, используется пустой массив.

Параметры

source:Array (default = null) — Массив, используемый в качестве источника для ArrayList.

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

addAll

()

метод

public function addAll(addList:IList):void

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Добавляет список элементов к текущему списку, помещая их в конце списка в порядке передачи.

Параметры

addList:IList — Список элементов, добавляемых к текущему списку

addAllAt

()

метод

public function addAllAt(addList:IList, index:int):void

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Добавляет список элементов к текущему списку, помещая их в позиции индекса, передаваемого в функцию. Элементы помещаются в позиции индекса в порядке их получения.

Параметры

	`addList:IList` — Список элементов, добавляемых к текущему списку

	`index:int` — Местоположение текущего списка для размещения новых элементов.

addItem

()

метод

public function addItem(item:Object):void

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Добавление указанного элемента в конец списка. Эквивалентен addItemAt(item, length);

Параметры

item:Object — Добавляемый элемент

addItemAt

()

метод

public function addItemAt(item:Object, index:int):void

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Добавление элемента в заданную позицию индекса. Любой элемент, прежде находившийся после данного индекса, перемещается на одну позицию.

Параметры

	`item:Object` — Элемент, помещаемый в позицию индекса

	`index:int` — Позиция индекса, в которую помещается элемент

Выдает

RangeError — если индекс меньше 0 или больше длины

getItemAt

()

метод

public function getItemAt(index:int, prefetch:int = 0):Object

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Получение элемента, расположенного в заданной позиции индекса.

Параметры

	`index:int` — Индекс в списке, из которого извлекается элемент

	`prefetch:int` (default = `0`) — Значение int, указывающее как направление, так и число элементов, получаемых во время запроса, если элемент не является локальным.

Возвращает

Object — Элемент в этой позиции индекса или значение null, если элемент отсутствует

Выдает

	`Error` — если данные для этого индекса следует загрузить из удаленного местоположения

	`RangeError` — если index < 0 или index > = length

getItemIndex

()

метод

public function getItemIndex(item:Object):int

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Возвращает индекс элемента, если он находится в списке, например getItemAt(index) == элемент. Следует отметить, что в этой реализации поиск линеен, и поэтому – O(n).

Параметры

item:Object — Искомый элемент

Возвращает

int — Индекс элемента или -1, если элемент отсутствует в списке.

itemUpdated

()

метод

public function itemUpdated(item:Object, property:Object = null, oldValue:Object = null, newValue:Object = null):void

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Уведомить представление об обновлении элемента. Это особенно важно, если содержимое представления не реализует IEventDispatcher. Если свойство указано, представление может оптимизировать свой механизм уведомления. В противном случае оно может выполнить простое обновление всего представления.

Параметры

	`item:Object` — Элемент представления, который был обновлен.

	`property:Object` (default = `null`) — Значения String, QName или int, определяющие обновленное свойство.

	`oldValue:Object` (default = `null`) — Старое значение данного свойства. (Если свойство имело значение null, это могло быть старое значение элемента.)

	`newValue:Object` (default = `null`) — Новое значение данного свойства. (Если свойство имело значение null, его можно не указывать, поскольку предполагается, что элемент является новым значением.)

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

mx.events.CollectionEvent
mx.core.IPropertyChangeNotifier
mx.events.PropertyChangeEvent

itemUpdateHandler

()

метод

protected function itemUpdateHandler(event:PropertyChangeEvent):void

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Вызывается при каждой отправке события ObjectChange любым из элементов в списке. Заключает его в объект CollectionEventKind.UPDATE.

Параметры

event:PropertyChangeEvent — Объект для события ObjectChange.

removeAll

()

метод

public function removeAll():void

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Удаляет все элементы из списка.

removeItem

()

метод

public function removeItem(item:Object):Boolean

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Удаляет указанный элемент из этого списка (при его наличии).

Параметры

item:Object — Ссылка на объект для элемента, подлежащего удалению.

Возвращает

Boolean — Логическое значение, указывающее на удаление элемента.

removeItemAt

()

метод

public function removeItemAt(index:int):Object

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

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

Параметры

index:int — Индекс, из которого необходимо удалить элемент.

Возвращает

Object — Удаленный элемент.

Выдает

RangeError — если индекс меньше 0 или больше или равен длине.

setItemAt

()

метод

public function setItemAt(item:Object, index:int):Object

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Помещает элемент в заданную позицию индекса. Если элемент уже занимает данную позицию индекса, новый элемент заменит его и будет возвращен.

Параметры

	`item:Object` — Новое значение индекса

	`index:int` — Позиция индекса, в которую помещается элемент

Возвращает

Object — Замененный элемент или null при отсутствии элемента

Выдает

RangeError — если индекс меньше 0 либо больше или равен длине

startTrackUpdates

()

метод

protected function startTrackUpdates(item:Object):void

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Если элемент - IEventDispatcher, следите за его обновлениями. Этот метод вызывается методом addItemAt() и при первоначальном назначении источника.

Параметры

item:Object — Элемент, переданный в метод addItemAt().

stopTrackUpdates

()

метод

protected function stopTrackUpdates(item:Object):void

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Если элемент – IEventDispatcher, следить за его обновлением не требуется. Этот метод вызывается removeItemAt() и removeAll() и перед назначением нового источника.

Параметры

item:Object — Элемент, переданный в метод removeItemAt().

toArray

()

метод

public function toArray():Array

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Возвращает массив, заполняемый в порядке, аналогичном реализации IList.

Возвращает

Array — Массив, заполняемый в порядке, аналогичном реализации IList.

Выдает

Error — Если данные еще не загружены полностью из удаленного местоположения

toString

()

метод

override public function toString():String

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Pretty вводит содержимое этого ArrayList в строку и возвращает ее.

Возвращает

String — Строка с содержимым ArrayList.

Сведения о событии

collectionChange

Событие

Тип объекта события: mx.events.CollectionEvent
свойство CollectionEvent.type = mx.events.CollectionEvent.COLLECTION_CHANGE

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Передается при некоторых обновлениях IList.

Константа 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

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

ArrayList - AS3 Flex

Классы x

length

source

uid

ArrayList

addAll

addAllAt

addItem

addItemAt

getItemAt

getItemIndex

itemUpdated

itemUpdateHandler

removeAll

removeItem

removeItemAt

setItemAt

startTrackUpdates

stopTrackUpdates

toArray

toString

collectionChange