| Package | fl.events | 
| Classe | public class DataChangeEvent | 
| Héritage | DataChangeEvent    Event   Object | 
| Version du langage: | ActionScript 3.0 | 
| Version du produit: | Flash CS3 | 
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 | 
Cette classe fournit l’événement suivant :
- 
                     
DataChangeEvent.DATA_CHANGE: diffusé lorsque les données du composant changent. 
Eléments de l’API associés
| 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 | |
| changeType : String [lecture seule] 
		 Récupère le type du changement qui a déclenché l’événement.  | DataChangeEvent | ||
![]()  | 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 | |
| endIndex : uint [lecture seule] 
         Récupère l’index du dernier élément modifié dans le tableau des éléments modifiés.  | DataChangeEvent | ||
![]()  | eventPhase : uint [lecture seule] 
	Phase actuelle du flux d’événements.  | Event | |
| items : Array [lecture seule] 
         Récupère un tableau contenant les éléments modifiés.  | DataChangeEvent | ||
| startIndex : uint [lecture seule] 
		 Récupère l’index du premier élément modifié dans le tableau des éléments modifiés.  | DataChangeEvent | ||
![]()  | target : Object [lecture seule] 
	Cible de l’événement.  | Event | |
![]()  | type : String [lecture seule] 
	Type d’événement.  | Event | |
| Méthode | Défini par | ||
|---|---|---|---|
DataChangeEvent(eventType:String, changeType:String, items:Array, startIndex:int = -1, endIndex:int = -1) 
		 Crée un nouvel objet DataChangeEvent avec les paramètres spécifiés.  | DataChangeEvent | ||
[override] 
		 Crée une copie de l’objet DataEvent et définit la valeur de chaque paramètre de sorte qu’elle corresponde à la valeur d’origine.  | DataChangeEvent | ||
![]()  | 
	 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 | |
[override] 
		 Renvoie une chaîne répertoriant toutes les propriétés de l’objet DataChangeEvent.  | DataChangeEvent | ||
![]()  | 
	 Renvoie la valeur primitive de l’objet spécifié.  | Object | |
| Constante | Défini par | ||
|---|---|---|---|
| DATA_CHANGE : String = "dataChange" [statique] 
         Définit la valeur de la propriété type d’un objet de l’événement dataChange.  | DataChangeEvent | ||
| PRE_DATA_CHANGE : String = "preDataChange" [statique] 
		 Définit la valeur de la propriété type d’un objet de l’événement preDataChange.  | DataChangeEvent | ||
changeType | propriété | 
changeType:String  [lecture seule] | Version du langage: | ActionScript 3.0 | 
| Version du produit: | Flash CS3 | 
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 | 
Récupère le type du changement qui a déclenché l’événement. La classe DataChangeType définit les valeurs possibles de cette propriété.
Implémentation
    public function get changeType():StringEléments de l’API associés
endIndex | propriété | 
endIndex:uint  [lecture seule] | Version du langage: | ActionScript 3.0 | 
| Version du produit: | Flash CS3 | 
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 | 
Récupère l’index du dernier élément modifié dans le tableau des éléments modifiés.
Implémentation
    public function get endIndex():uintEléments de l’API associés
items | propriété | 
startIndex | propriété | 
startIndex:uint  [lecture seule] | Version du langage: | ActionScript 3.0 | 
| Version du produit: | Flash CS3 | 
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 | 
Récupère l’index du premier élément modifié dans le tableau des éléments modifiés.
Implémentation
    public function get startIndex():uintEléments de l’API associés
DataChangeEvent | () | Constructeur | 
public function DataChangeEvent(eventType:String, changeType:String, items:Array, startIndex:int = -1, endIndex:int = -1)| Version du langage: | ActionScript 3.0 | 
| Version du produit: | Flash CS3 | 
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 | 
Crée un nouvel objet DataChangeEvent avec les paramètres spécifiés.
ParamètreseventType:String — Type d’événement change.
		 
		  | |
changeType:String — Type du changement effectué. La classe DataChangeType définit les valeurs possibles de ce paramètre.
		 
		  | |
items:Array — Liste des éléments modifiés.
		 
		  | |
startIndex:int (default = -1) — Index du premier élément modifié.
         
          | |
endIndex:int (default = -1) — Index du dernier élément modifié.
         
          | 
clone | () | méthode | 
override public function clone():Event| Version du langage: | ActionScript 3.0 | 
| Version du produit: | Flash CS3 | 
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 | 
Crée une copie de l’objet DataEvent et définit la valeur de chaque paramètre de sorte qu’elle corresponde à la valeur d’origine.
Valeur renvoyéeEvent — Nouvel objet DataChangeEvent dont les propriétés ont la même valeur que celles de l’objet d’origine.
         
          | 
toString | () | méthode | 
override public function toString():String| Version du langage: | ActionScript 3.0 | 
| Version du produit: | Flash CS3 | 
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 | 
Renvoie une chaîne répertoriant toutes les propriétés de l’objet DataChangeEvent. La chaîne est écrite au format suivant :
[ DataChangeEvent type= valeur changeType= valeur startIndex= valeur endIndex= valeur bubbles= valeur cancelable= valeur]
String — Chaîne répertoriant toutes les propriétés de l’objet DataChangeEvent.
         
          | 
DATA_CHANGE | Constante | 
public static const DATA_CHANGE:String = "dataChange"| Version du langage: | ActionScript 3.0 | 
| Version du produit: | Flash CS3 | 
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 | 
         Définit la valeur de la propriété type d’un objet de l’événement dataChange. 
		 
		 
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur | 
|---|---|
bubbles | false | 
cancelable | false ; il n’existe aucun comportement par défaut à annuler. | 
changeType | Indique le type du changement effectué. | 
currentTarget | Objet qui traite activement l’objet de l’événement avec un écouteur d’événement. | 
endIndex | Identifie l’index du dernier élément modifié. | 
items | Tableau qui dresse la liste des éléments modifiés. | 
startIndex | Identifie l’index du premier élément modifié. | 
target | Objet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget. | 
Eléments de l’API associés
PRE_DATA_CHANGE | Constante | 
public static const PRE_DATA_CHANGE:String = "preDataChange"| Version du langage: | ActionScript 3.0 | 
| Version du produit: | Flash CS3 | 
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 | 
		 Définit la valeur de la propriété type d’un objet de l’événement preDataChange. Cet objet d’événement est distribué avant le changement des données du composant.
		 
		 
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur | 
|---|---|
bubbles | false | 
cancelable | false ; il n’existe aucun comportement par défaut à annuler. | 
changeType | Indique le type du changement à effectuer. | 
currentTarget | Objet qui traite activement l’objet de l’événement avec un écouteur d’événement. | 
endIndex | Identifie l’index du dernier élément à modifier. | 
items | Tableau qui dresse la liste des éléments à modifier. | 
startIndex | Identifie l’index du premier élément à modifier. | 
target | Objet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété currentTarget. | 
Eléments de l’API associés
- Ajoutez une classe DataGrid et des classes Buttons à la bibliothèque.
 - Enregistrez ce code sous le nom DataChangeEventExample.as dans le même répertoire que votre fichier FLA.
 - Dans le fichier FLA, définissez DocumentClass sur DataChangeEventExample.
 
package
{
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import fl.data.DataProvider;
    import fl.events.DataChangeEvent;
    import fl.controls.DataGrid;
    import fl.controls.Button;
    
    public class DataChangeEventExample extends Sprite
    {
        private var dg:DataGrid;
        private var dp:DataProvider;
        private var names:Array = [ "Mary", "Bob", "Sue", "Joe" ];
        
        public function DataChangeEventExample() {
            dp = new DataProvider();
            dp.addEventListener(DataChangeEvent.DATA_CHANGE,dataChanged);
        
            dg = new DataGrid();
            dg.move(10,45);
            dg.setSize(300,250);
            dg.columns = [ "name", "phone", "email" ];
            addChild(dg);
            var addContactBtn:Button = new Button();
            addContactBtn.label = "Add Contact";
            addContactBtn.move(10,10);
            addContactBtn.addEventListener(MouseEvent.CLICK, addContact);
            addChild(addContactBtn);            
        }
        
        private function getRandomPhone():String {
            return randomDigit()+randomDigit()+randomDigit()+"-"+randomDigit()+randomDigit()+randomDigit()+"-"+randomDigit()+randomDigit()+randomDigit()+randomDigit();    
        }
        private function randomDigit():String {
            return String(Math.round(Math.random()*10)%10);    
        }
        private function getRandomName():String {
            return names[Math.round(Math.random()*names.length)%names.length];    
        }
        private function addContact(e:MouseEvent):void {
            var randomName:String = getRandomName()
            dp.addItem( { name: randomName, phone: getRandomPhone(), email: randomName + "@fictitious.com" } );
        }
        private function dataChanged(e:DataChangeEvent):void {
            var changedItems:Array = e.items;
            dg.addItem(changedItems[0]);
        }
    }
}
Tue Jun 12 2018, 09:30 AM Z
 
 Masquer les propriétés publiques héritées
 Afficher les propriétés publiques héritées