| 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 |
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
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éthode | Défini par | ||
|---|---|---|---|
Construire une nouvelle classe ArrayList à l’aide du tableau spécifié comme source. | ArrayList | ||
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 | ||
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 | |
Ajoutez l’élément spécifié à la fin de la liste. | ArrayList | ||
Ajoutez l’élément à l’index spécifié. | ArrayList | ||
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
Obtenez l’élément à l’index spécifié. | ArrayList | ||
Renvoie l’index de l’élément s’il se trouve dans la liste, de sorte que getItemAt(index) == élément. | ArrayList | ||
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
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 | ||
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
Supprime tous les éléments de la liste. | ArrayList | ||
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
Supprime l’élément spécifié de cette liste, s’il existe. | ArrayList | ||
Supprime l’élément qui se trouve à l’index spécifié et le renvoie. | ArrayList | ||
Placez l’élément à l’index spécifié. | ArrayList | ||
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
Renvoyez un tableau rempli dans le même ordre que l’implémentation de l’interface IList. | ArrayList | ||
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
[override]
Imprime le contenu de cette classe ArrayList dans une chaîne et la renvoie. | ArrayList | ||
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
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éthode | Défini par | ||
|---|---|---|---|
Appelé lorsqu’un des éléments contenus dans la liste distribue un événement ObjectChange. | ArrayList | ||
Si l’élément est une interface IEventDispatcher, recherchez les mises à jour. | ArrayList | ||
Si l’élément est une interface IEventDispatcher, arrêtez de rechercher les mises à jour. | ArrayList | ||
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| Distribué lorsque l’interface IList a été mise à jour. | ArrayList | |||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
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():intsource | 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):voiduid | propriété |
ArrayList | () | 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ètressource:Array (default = null) |
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 |
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) |
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
|
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) | |
oldValue:Object (default = null) | |
newValue:Object (default = null) |
Eléments de l’API associés
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é.
|
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é.
|
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
|
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éeArray — 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éeString — Chaîne contenant le contenu de la classe ArrayList.
|
collectionChange | Evénement |
mx.events.CollectionEventproprié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 |
Tue Jun 12 2018, 09:30 AM Z