| Package | mx.events |
| Classe | public class CollectionEvent |
| Héritage | CollectionEvent  Event Object |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Eléments de l’API associés
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | bubbles : Boolean [lecture seule]
Indique si un événement peut se propager vers le haut (bubbling). | Event | |
| cancelable : Boolean [lecture seule]
Indique si le comportement associé à l’événement peut être évité. | Event | |
| constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| currentTarget : Object [lecture seule]
L’objet qui traite activement l’objet Event avec un écouteur d’événements. | Event | |
| eventPhase : uint [lecture seule]
Phase actuelle du flux d’événements. | Event | |
| items : Array
Lorsque la valeur de kind est CollectionEventKind.ADD ou CollectionEventKind.REMOVE, la propriété items est un tableau d’éléments ajoutés/supprimés. | CollectionEvent | ||
| kind : String
Indique le type d’événement survenu. | CollectionEvent | ||
| location : int
Lorsque la valeur de kind est CollectionEventKind.ADD, CollectionEventKind.MOVE, CollectionEventKind.REMOVE ou CollectionEventKind.REPLACE, cette propriété est l’index de base zéro dans la collection cible du ou des éléments spécifiés dans la propriété items. | CollectionEvent | ||
| oldLocation : int
Lorsque la valeur de kind est CollectionEventKind.MOVE, cette propriété est l’index de base zéro dans la collection cible de l’emplacement du ou des éléments spécifiés par la propriété items. | CollectionEvent | ||
| target : Object [lecture seule]
Cible de l’événement. | Event | |
| type : String [lecture seule]
Type d’événement. | Event | |
| Méthode | Défini par | ||
|---|---|---|---|
CollectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, kind:String = null, location:int = -1, oldLocation:int = -1, items:Array = null)
Constructeur. | CollectionEvent | ||
|
Duplique une occurrence d’une sous-classe Event. | Event | |
|
Fonction d’un utilitaire permettant d’implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées. | Event | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Vérifie si la méthode preventDefault() a été appelée pour l’événement. | Event | |
|
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 | |
|
Annule le comportement par défaut d’un événement si cette opération est possible. | Event | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d’événements. | Event | |
|
Bloque le traitement des écouteurs d’événement dans les nœuds qui suivent le nœud actuel dans le flux d’événements. | Event | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie une chaîne répertoriant toutes les propriétés de l’objet Event. | Event | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
| Constante | Défini par | ||
|---|---|---|---|
| COLLECTION_CHANGE : String = "collectionChange" [statique]
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é. | CollectionEvent | ||
items | propriété |
public var items:Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Lorsque la valeur de kind est CollectionEventKind.ADD ou CollectionEventKind.REMOVE, la propriété items est un tableau d’éléments ajoutés/supprimés. Lorsque la valeur de kind est CollectionEventKind.REPLACE ou CollectionEventKind.UPDATE, la propriété items est un tableau d’objets PropertyChangeEvent contenant des informations sur les éléments affectés par l’événement. Lorsqu’une valeur change, interrogez les champs newValue et oldValue des objets PropertyChangeEvent pour connaître l’ancienne valeur et la nouvelle valeur. Lorsque la valeur de kind est CollectionEventKind.REFRESH ou CollectionEventKind.RESET, la longueur de ce tableau est égale à zéro.
La valeur par défaut est [ ].
Eléments de l’API associés
kind | propriété |
public var kind:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique le type d’événement survenu. La valeur de la propriété peut être l’une des valeurs de la classe CollectionEventKind ou null, ce qui indique que la catégorie est inconnue.
La valeur par défaut est null.
Eléments de l’API associés
location | propriété |
public var location:int| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Lorsque la valeur de kind est CollectionEventKind.ADD, CollectionEventKind.MOVE, CollectionEventKind.REMOVE ou CollectionEventKind.REPLACE, cette propriété est l’index de base zéro dans la collection cible du ou des éléments spécifiés dans la propriété items.
La valeur par défaut est -1.
Eléments de l’API associés
oldLocation | propriété |
public var oldLocation:int| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Lorsque la valeur de kind est CollectionEventKind.MOVE, cette propriété est l’index de base zéro dans la collection cible de l’emplacement du ou des éléments spécifiés par la propriété items.
La valeur par défaut est -1.
CollectionEvent | () | Constructeur |
public function CollectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, kind:String = null, location:int = -1, oldLocation:int = -1, items: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 |
Constructeur.
Paramètrestype:String — Type d’événement ; indique l’action qui a déclenché l’événement.
| |
bubbles:Boolean (default = false) | |
cancelable:Boolean (default = false) | |
kind:String (default = null)null, ce qui indique que la catégorie est inconnue.
| |
location:int (default = -1)kind est CollectionEventKind.ADD, CollectionEventKind.MOVE, CollectionEventKind.REMOVE ou CollectionEventKind.REPLACE, cette valeur indique l’emplacement dans la collection cible du ou des éléments spécifiés dans la propriété items.
| |
oldLocation:int (default = -1)kind est CollectionEventKind.MOVE, cette valeur indique l’ancien emplacement dans la collection cible du ou des éléments spécifiés dans la propriété items.
| |
items:Array (default = null)items. Lorsque la valeur de kind est CollectionEventKind.REFRESH ou CollectionEventKind.RESET, la longueur de ce tableau est égale à zéro.
|
COLLECTION_CHANGE | Constante |
public static const COLLECTION_CHANGE:String = "collectionChange"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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