ArrayList

Package	mx.collections
Classe	public class ArrayList
Héritage	ArrayList EventDispatcher Object
Implémente	IList, IExternalizable, IPropertyChangeNotifier
Sous-classes	Conflicts

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

La classe ArrayList est une simple implémentation de l’interface IList qui utilise un tableau de sauvegarde comme source de données. Les éléments du tableau de sauvegarde peuvent être accédés et manipulés avec les méthodes et les propriétés de l’interface IList. Les opérations réalisées sur une instance ArrayList modifient la source de données. Par exemple, si vous utilisez la méthode removeItemAt() sur une classe ArrayList, vous supprimez l’élément du tableau sous-jacent. Cette classe de base ne renverra pas d’objets ItemPendingError mais il est possible qu’une sous-classe le puisse.

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

Propriété MXML par défautsource

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		length : int [lecture seule] Obtenez le nombre d’éléments de la liste.	ArrayList
		source : Array Le tableau source pour cette classe ArrayList.	ArrayList
		uid : String Permet d’accéder à l’ID unique de cette liste.	ArrayList

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		ArrayList(source:Array = null) Construire une nouvelle classe ArrayList à l’aide du tableau spécifié comme source.	ArrayList
		addAll(addList:IList):void Ajoute une liste d’éléments à la liste actuelle, en les plaçant à la fin de la liste, dans l’ordre dans lequel ils sont transmis.	ArrayList
		addAllAt(addList:IList, index:int):void Ajoute une liste d’éléments à la liste actuelle, en les plaçant à l’index de position transmis à la fonction.	ArrayList
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.	EventDispatcher
		addItem(item:Object):void Ajoutez l’élément spécifié à la fin de la liste.	ArrayList
		addItemAt(item:Object, index:int):void Ajoutez l’élément à l’index spécifié.	ArrayList
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		getItemAt(index:int, prefetch:int = 0):Object Obtenez l’élément à l’index spécifié.	ArrayList
		getItemIndex(item:Object):int Renvoie l’index de l’élément s’il se trouve dans la liste, de sorte que getItemAt(index) == élément.	ArrayList
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		itemUpdated(item:Object, property:Object = null, oldValue:Object = null, newValue:Object = null):void Signale à la vue qu’un élément a été mis à jour.	ArrayList
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeAll():void Supprime tous les éléments de la liste.	ArrayList
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		removeItem(item:Object):Boolean Supprime l’élément spécifié de cette liste, s’il existe.	ArrayList
		removeItemAt(index:int):Object Supprime l’élément qui se trouve à l’index spécifié et le renvoie.	ArrayList
		setItemAt(item:Object, index:int):Object Placez l’élément à l’index spécifié.	ArrayList
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toArray():Array Renvoyez un tableau rempli dans le même ordre que l’implémentation de l’interface IList.	ArrayList
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String [override] Imprime le contenu de cette classe ArrayList dans une chaîne et la renvoie.	ArrayList
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.	EventDispatcher

Méthodes protégées

	Méthode		Défini par
		itemUpdateHandler(event:PropertyChangeEvent):void Appelé lorsqu’un des éléments contenus dans la liste distribue un événement ObjectChange.	ArrayList
		startTrackUpdates(item:Object):void Si l’élément est une interface IEventDispatcher, recherchez les mises à jour.	ArrayList
		stopTrackUpdates(item:Object):void Si l’élément est une interface IEventDispatcher, arrêtez de rechercher les mises à jour.	ArrayList

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
collectionChange	Distribué lorsque l’interface IList a été mise à jour.	ArrayList
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher

Détails de la propriété

length

propriété

length:int [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Obtenez le nombre d’éléments de la liste. Une classe ArrayList doit toujours connaître sa longueur. Il ne doit donc pas être renvoyé -1, une sous-classe peut annuler ce comportement.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement collectionChange .

Implémentation
public function get length():int

source

propriété

source:Array

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Le tableau source pour cette classe ArrayList. Toutes les modifications effectuées à l’aide de l’interface IList seront répercutées dans le tableau source. Si aucun tableau source n’a été fourni, la classe ArrayList va en créer un en interne. Les modifications apportées directement au tableau sous-jacent (par exemple, en appelant theList.source.pop() n’entraîneront pas la distribution de classes CollectionEvents.

Implémentation
public function get source():Array
public function set source(value:Array):void

uid

propriété

uid:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Permet d’accéder à l’ID unique de cette liste.

Implémentation
public function get uid():String
public function set uid(value:String):void

Détails du constructeur

()

Constructeur

public function ArrayList(source:Array = null)

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Construire une nouvelle classe ArrayList à l’aide du tableau spécifié comme source. Si aucune source n’est spécifiée, un tableau vide est utilisé.

Paramètres

source:Array (default = null) — Tableau à utiliser en tant que source pour la classe ArrayList.

Détails de la méthode

addAll

()

méthode

public function addAll(addList:IList):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Ajoute une liste d’éléments à la liste actuelle, en les plaçant à la fin de la liste, dans l’ordre dans lequel ils sont transmis.

Paramètres

addList:IList — Liste d’éléments à ajouter à la liste actuelle.

addAllAt

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Ajoute une liste d’éléments à la liste actuelle, en les plaçant à l’index de position transmis à la fonction. Les éléments sont placés à l’emplacement de l’index, dans l’ordre dans lequel ils sont reçus.

Paramètres

	`addList:IList` — Liste d’éléments à ajouter à la liste actuelle.

	`index:int` — Emplacement de la liste actuelle où les nouveaux éléments doivent être placés.

addItem

()

méthode

public function addItem(item:Object):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Ajoutez l’élément spécifié à la fin de la liste. Equivaut à addItemAt(élément, longueur) ;

Paramètres

item:Object — Elément à ajouter

addItemAt

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Ajoutez l’élément à l’index spécifié. Tout élément qui était après cet index est déplacé d’une place.

Paramètres

	`item:Object` — l’élément à placer à l’index

	`index:int` — l’index sur lequel placer l’élément

Valeur émise

RangeError — si l’index est inférieur à 0 ou supérieur à la longueur

getItemAt

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Obtenez l’élément à l’index spécifié.

Paramètres

	`index:int` — l’index dans la liste à partir duquel récupérer l’élément

	`prefetch:int` (default = `0`) — Valeur int indiquant le nombre d’éléments à récupérer au cours de la demande si l’élément n’est pas local, ainsi que leur direction.

Valeur renvoyée

Object — l’élément qui se trouve à cet index ou null si aucun élément n’est retrouvé

Valeur émise

	`Error` — si les données de cet index doivent être chargées à partir d’un emplacement distant

	`RangeError` — si l’index < 0 ou index >= longueur

getItemIndex

()

méthode

public function getItemIndex(item:Object):int

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie l’index de l’élément s’il se trouve dans la liste, de sorte que getItemAt(index) == élément. Notez que, dans cette implémentation, la recherche est linéaire et est donc O(n).

Paramètres

item:Object — Elément à retrouver

Valeur renvoyée

int — l’index de l’élément, -1 si l’élément n’est pas dans la liste.

itemUpdated

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Signale à la vue qu’un élément a été mis à jour. Cette méthode est utile lorsque le contenu de la vue n’implémente pas l’interface IPropertyDispatcher. Si une propriété est spécifiée, il est possible que la vue puisse optimiser son mécanisme de notification. Dans le cas contraire, elle peut simplement choisir d’actualiser l’ensemble de la vue.

Paramètres

	`item:Object` — Elément mis à jour dans la vue.

	`property:Object` (default = `null`) — Chaîne, valeur QName ou entier indiquant la propriété modifiée.

	`oldValue:Object` (default = `null`) — Ancienne valeur de cette propriété (si la valeur de la propriété était null, il peut s’agir de l’ancienne valeur de l’élément).

	`newValue:Object` (default = `null`) — Nouvelle valeur de cette propriété (si la valeur de la propriété était null, il n’est pas nécessaire de la spécifier, car l’élément est supposé correspondre à la nouvelle valeur).

Eléments de l’API associés

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

itemUpdateHandler

()

méthode

protected function itemUpdateHandler(event:PropertyChangeEvent):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Appelé lorsqu’un des éléments contenus dans la liste distribue un événement ObjectChange. L’enveloppe dans un objet CollectionEventKind.UPDATE.

Paramètres

event:PropertyChangeEvent — Objet événement de l’événement ObjectChange.

removeAll

()

méthode

public function removeAll():void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Supprime tous les éléments de la liste.

removeItem

()

méthode

public function removeItem(item:Object):Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Supprime l’élément spécifié de cette liste, s’il existe.

Paramètres

item:Object — Référence de l’objet de l’élément qui doit être supprimé.

Valeur renvoyée

Boolean — Valeur booléenne qui indique si l’élément a été supprimé.

removeItemAt

()

méthode

public function removeItemAt(index:int):Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Supprime l’élément qui se trouve à l’index spécifié et le renvoie. Tous les éléments qui se trouvent après cet index se trouvent désormais avancés d’un index.

Paramètres

index:int — Index auquel l’élément doit être supprimé.

Valeur renvoyée

Object — Elément qui a été supprimé.

Valeur émise

RangeError — Erreur renvoyée lorsque index < 0 ou index >= length.

setItemAt

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Placez l’élément à l’index spécifié. Si un élément se trouvait déjà à cet index, le nouvel élément le remplace et il est renvoyé.

Paramètres

	`item:Object` — Nouvelle valeur de l’index

	`index:int` — l’index sur lequel placer l’élément

Valeur renvoyée

Object — Elément remplacé ou null si aucun élément n’a été remplacé

Valeur émise

RangeError — si l’index est inférieur à 0 ou supérieur ou égal à la longueur

startTrackUpdates

()

méthode

protected function startTrackUpdates(item:Object):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Si l’élément est une interface IEventDispatcher, recherchez les mises à jour. Cette méthode est appelée par la méthode addItemAt() et lorsque la source est affectée initialement.

Paramètres

item:Object — Elément transmis à la méthodeaddItemAt().

stopTrackUpdates

()

méthode

protected function stopTrackUpdates(item:Object):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Si l’élément est une interface IEventDispatcher, arrêtez de rechercher les mises à jour. Cette méthode est appelée par les méthodes removeItemAt() et removeAll(), et avant l’affectation d’une nouvelle source.

Paramètres

item:Object — Elément transmis à la méthoderemoveItemAt().

toArray

()

méthode

public function toArray():Array

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoyez un tableau rempli dans le même ordre que l’implémentation de l’interface IList.

Valeur renvoyée

Array — Tableau rempli dans le même ordre que l’implémentation de l’interface IList.

Valeur émise

Error — si les données n’ont pas encore été entièrement chargées à partir d’un emplacement distant

toString

()

méthode

override public function toString():String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Imprime le contenu de cette classe ArrayList dans une chaîne et la renvoie.

Valeur renvoyée

String — Chaîne contenant le contenu de la classe ArrayList.

Détails de l’événement

collectionChange

Evénement

Type d’objet d’événement: mx.events.CollectionEvent
propriété CollectionEvent.type = mx.events.CollectionEvent.COLLECTION_CHANGE

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Distribué lorsque l’interface IList a été mise à jour.

La constante CollectionEvent.COLLECTION_CHANGE définit la valeur de la propriété type de l’objet d’événement d’un événement distribué lorsqu’une collection a changé.

Les valeurs des propriétés de l’objet d’événement sont les suivantes : Toutes les propriétés ne sont pas pertinentes pour chaque catégorie d’événements. Pour plus d’informations, voir les descriptions détaillées des propriétés.

Propriété	Valeur
`bubbles`	false
`cancelable`	false
`currentTarget`	Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez `myButton.addEventListener()` pour enregistrer un écouteur d’événement, myButton est la valeur de `currentTarget`.
`items`	Tableau d’objets contenant des informations sur les éléments affectés par l’événement. Le contenu de ce champ dépend du type d’événement. Pour plus d’informations, voir la propriété `items`.
`kind`	Type d’événement. Les valeurs possibles sont définies dans la classe CollectionEventKind sous forme de constantes.
`location`	Emplacement dans la collection cible du ou des éléments spécifiés dans la propriété `items`.
`oldLocation`	Ancien emplacement dans la collection de l’élément spécifié dans la propriété `items`.
`target`	Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété `currentTarget`.
`type`	CollectionEvent.COLLECTION_CHANGE

Informations juridiques | Politique de confidentialité en ligne

ArrayList - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package mx.collections

length

source

uid

ArrayList

addAll

addAllAt

addItem

addItemAt

getItemAt

getItemIndex

itemUpdated

itemUpdateHandler

removeAll

removeItem

removeItemAt

setItemAt

startTrackUpdates

stopTrackUpdates

toArray

toString

collectionChange