ArrayList

Pakiet	mx.collections
Klasa	public class ArrayList
Dziedziczenie	ArrayList EventDispatcher Object
Implementuje	IList, IExternalizable, IPropertyChangeNotifier
Podklasy	Conflicts

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 4

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5

The ArrayList class is a simple implementation of IList that uses a backing Array as the source of the data. Items in the backing Array can be accessed and manipulated using the methods and properties of the IList interface. Operations on an ArrayList instance modify the data source; for example, if you use the removeItemAt() method on an ArrayList, you remove the item from the underlying Array. This base class will not throw ItemPendingErrors but it is possible that a subclass might.

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

Domyślna właściwość MXMLsource

Właściwości publiczne

Ukryj dziedziczone właściwości publiczne

Pokaż dziedziczone właściwości publiczne

	Właściwość		Zdefiniowane przez
		constructor : Object Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.	Object
		length : int [tylko do odczytu] Get the number of items in the list.	ArrayList
		source : Array The source array for this ArrayList.	ArrayList
		uid : String Provides access to the unique id for this list.	ArrayList

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		ArrayList(source:Array = null) Construct a new ArrayList using the specified array as its source.	ArrayList
		addAll(addList:IList):void Adds a list of items to the current list, placing them at the end of the list in the order they are passed.	ArrayList
		addAllAt(addList:IList, index:int):void Adds a list of items to the current list, placing them at the position index passed in to the function.	ArrayList
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu.	EventDispatcher
		addItem(item:Object):void Add the specified item to the end of the list.	ArrayList
		addItemAt(item:Object, index:int):void Add the item at the specified index.	ArrayList
		dispatchEvent(event:Event):Boolean Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.	EventDispatcher
		getItemAt(index:int, prefetch:int = 0):Object Get the item at the specified index.	ArrayList
		getItemIndex(item:Object):int Return the index of the item if it is in the list such that getItemAt(index) == item.	ArrayList
		hasEventListener(type:String):Boolean Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.	EventDispatcher
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		itemUpdated(item:Object, property:Object = null, oldValue:Object = null, newValue:Object = null):void Notify the view that an item has been updated.	ArrayList
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		removeAll():void Remove all items from the list.	ArrayList
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Usuwa detektor z obiektu EventDispatcher.	EventDispatcher
		removeItem(item:Object):Boolean Removes the specified item from this list, should it exist.	ArrayList
		removeItemAt(index:int):Object Remove the item at the specified index and return it.	ArrayList
		setItemAt(item:Object, index:int):Object Place the item at the specified index.	ArrayList
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		toArray():Array Return an Array that is populated in the same order as the IList implementation.	ArrayList
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String [przesłanianie] Pretty prints the contents of this ArrayList to a string and returns it.	ArrayList
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object
		willTrigger(type:String):Boolean Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.	EventDispatcher

Metody chronione

	Metoda		Zdefiniowane przez
		itemUpdateHandler(event:PropertyChangeEvent):void Called when any of the contained items in the list dispatch an ObjectChange event.	ArrayList
		startTrackUpdates(item:Object):void If the item is an IEventDispatcher, watch it for updates.	ArrayList
		stopTrackUpdates(item:Object):void If the item is an IEventDispatcher, stop watching it for updates.	ArrayList

Zdarzenia

Kliknij, aby uzyskać więcej informacji o zdarzeniach

Ukryj zdarzenia dziedziczone

Pokaż zdarzenia dziedziczone

	Podsumowanie	Zdefiniowane przez
activate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny.	EventDispatcher
collectionChange	Dispatched when the IList has been updated in some way.	ArrayList
deactivate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.	EventDispatcher

Szczegół właściwości

length

właściwość

length:int [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Get the number of items in the list. An ArrayList should always know its length so it shouldn't return -1, though a subclass may override that behavior.

Ta właściwość może być używana jako źródło dla tworzenia powiązań danych. Jeśli ta właściwość zostanie zmodyfikowana, zostanie wywołane zdarzenie collectionChange .

Implementacja
public function get length():int

source

właściwość

source:Array

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

The source array for this ArrayList. Any changes done through the IList interface will be reflected in the source array. If no source array was supplied the ArrayList will create one internally. Changes made directly to the underlying Array (e.g., calling theList.source.pop() will not cause CollectionEvents to be dispatched.

Implementacja
public function get source():Array
public function set source(value:Array):void

uid

właściwość

uid:String

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Provides access to the unique id for this list.

Implementacja
public function get uid():String
public function set uid(value:String):void

Konstruktor Szczegół

()

Konstruktor

public function ArrayList(source:Array = null)

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Construct a new ArrayList using the specified array as its source. If no source is specified an empty array will be used.

Parametry

source:Array (default = null) — The Array to use as a source for the ArrayList.

Szczegół metody

addAll

()

metoda

public function addAll(addList:IList):void

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Adds a list of items to the current list, placing them at the end of the list in the order they are passed.

Parametry

addList:IList — The list of items to add to the current list

addAllAt

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Adds a list of items to the current list, placing them at the position index passed in to the function. The items are placed at the index location and placed in the order they are recieved.

Parametry

	`addList:IList` — The list of items to add to the current list

	`index:int` — The location of the current list to place the new items.

addItem

()

metoda

public function addItem(item:Object):void

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Add the specified item to the end of the list. Equivalent to addItemAt(item, length);

Parametry

item:Object — the item to add

addItemAt

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Add the item at the specified index. Any item that was after this index is moved out by one.

Parametry

	`item:Object` — the item to place at the index

	`index:int` — the index at which to place the item

Zgłasza

RangeError — if index is less than 0 or greater than the length

getItemAt

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Get the item at the specified index.

Parametry

	`index:int` — the index in the list from which to retrieve the item

	`prefetch:int` (default = `0`) — int indicating both the direction and amount of items to fetch during the request should the item not be local.

Zwraca

Object — the item at that index, null if there is none

Zgłasza

	`Error` — if the data for that index needs to be loaded from a remote location

	`RangeError` — if the index < 0 or index >= length

getItemIndex

()

metoda

public function getItemIndex(item:Object):int

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Return the index of the item if it is in the list such that getItemAt(index) == item. Note that in this implementation the search is linear and is therefore O(n).

Parametry

item:Object — the item to find

Zwraca

int — the index of the item, -1 if the item is not in the list.

itemUpdated

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Notify the view that an item has been updated. This is useful if the contents of the view do not implement IEventDispatcher. If a property is specified the view may be able to optimize its notification mechanism. Otherwise it may choose to simply refresh the whole view.

Parametry

	`item:Object` — The item within the view that was updated.

	`property:Object` (default = `null`) — A String, QName, or int specifying the property that was updated.

	`oldValue:Object` (default = `null`) — The old value of that property. (If property was null, this can be the old value of the item.)

	`newValue:Object` (default = `null`) — The new value of that property. (If property was null, there's no need to specify this as the item is assumed to be the new value.)

Powiązane elementy interfejsu API

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

itemUpdateHandler

()

metoda

protected function itemUpdateHandler(event:PropertyChangeEvent):void

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Called when any of the contained items in the list dispatch an ObjectChange event. Wraps it in a CollectionEventKind.UPDATE object.

Parametry

event:PropertyChangeEvent — The event object for the ObjectChange event.

removeAll

()

metoda

public function removeAll():void

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Remove all items from the list.

removeItem

()

metoda

public function removeItem(item:Object):Boolean

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Removes the specified item from this list, should it exist.

Parametry

item:Object — Object reference to the item that should be removed.

Zwraca

Boolean — Boolean indicating if the item was removed.

removeItemAt

()

metoda

public function removeItemAt(index:int):Object

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Remove the item at the specified index and return it. Any items that were after this index are now one index earlier.

Parametry

index:int — The index from which to remove the item.

Zwraca

Object — The item that was removed.

Zgłasza

RangeError — if index < 0 or index >= length.

setItemAt

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Place the item at the specified index. If an item was already at that index the new item will replace it and it will be returned.

Parametry

	`item:Object` — the new value for the index

	`index:int` — the index at which to place the item

Zwraca

Object — the item that was replaced, null if none

Zgłasza

RangeError — if index is less than 0 or greater than or equal to length

startTrackUpdates

()

metoda

protected function startTrackUpdates(item:Object):void

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

If the item is an IEventDispatcher, watch it for updates. This method is called by the addItemAt() method, and when the source is initially assigned.

Parametry

item:Object — The item passed to the addItemAt() method.

stopTrackUpdates

()

metoda

protected function stopTrackUpdates(item:Object):void

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

If the item is an IEventDispatcher, stop watching it for updates. This method is called by the removeItemAt() and removeAll() methods, and before a new source is assigned.

Parametry

item:Object — The item passed to the removeItemAt() method.

toArray

()

metoda

public function toArray():Array

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Return an Array that is populated in the same order as the IList implementation.

Zwraca

Array — An Array populated in the same order as the IList implementation.

Zgłasza

Error — if the data is not yet completely loaded from a remote location

toString

()

metoda

override public function toString():String

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Pretty prints the contents of this ArrayList to a string and returns it.

Zwraca

String — A String containing the contents of the ArrayList.

Szczegół zdarzenia

collectionChange

Zdarzenie

Typ obiektu zdarzenia: mx.events.CollectionEvent
właściwość CollectionEvent.type = mx.events.CollectionEvent.COLLECTION_CHANGE

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flex 3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.1

Dispatched when the IList has been updated in some way.

The CollectionEvent.COLLECTION_CHANGE constant defines the value of the type property of the event object for an event that is dispatched when a collection has changed.

The properties of the event object have the following values. Not all properties are meaningful for all kinds of events. See the detailed property descriptions for more information.

Property	Value
`bubbles`	false
`cancelable`	false
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`items`	An Array of objects with information about the items affected by the event. The contents of this field depend on the event kind; for details see the `items` property
`kind`	The kind of event. The valid values are defined in the CollectionEventKind class as constants.
`location`	Location within the target collection of the item(s) specified in the `items` property.
`oldLocation`	the previous location in the collection of the item specified in the `items` property.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.
`type`	CollectionEvent.COLLECTION_CHANGE

Informacje prawne | Zasady prywatności online

ArrayList - AS3 Flex

Pakietyx

Elementy językowe

Dodatki

Pakiet mx.collections

length

source

uid

ArrayList

addAll

addAllAt

addItem

addItemAt

getItemAt

getItemIndex

itemUpdated

itemUpdateHandler

removeAll

removeItem

removeItemAt

setItemAt

startTrackUpdates

stopTrackUpdates

toArray

toString

collectionChange