Packagefl.events
Classepublic class DataChangeEvent
HéritageDataChangeEvent Inheritance Event Inheritance Object

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

La classe DataChangeEvent définit l'événement qui est diffusé lorsque les données associées à un composant changent. Cet événement est utilisé par les composants List, DataGrid, TileList et ComboBox.

Cette classe fournit l'événement suivant :

Consulter les exemples

Voir aussi

DataChangeType


Propriétés publiques
 PropriétéDéfini par
 Inheritedbubbles : Boolean
[lecture-seule] Indique si un événement peut se propager vers le haut (bubbling).
Event
 Inheritedcancelable : Boolean
[lecture-seule] Indique si le comportement associé à l’événement peut être annulé.
Event
  changeType : String
[lecture-seule] Récupère le type du changement qui a déclenché l'événement.
DataChangeEvent
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
 InheritedcurrentTarget : 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
 InheritedeventPhase : 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
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
  startIndex : uint
[lecture-seule] Récupère l'index du premier élément modifié dans le tableau des éléments modifiés.
DataChangeEvent
 Inheritedtarget : Object
[lecture-seule] Cible de l’événement.
Event
 Inheritedtype : String
[lecture-seule] Type d’événement.
Event
Méthodes publiques
 MéthodeDé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
  
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
 Inherited
formatToString(className:String, ... arguments):String
Fonction d’un utilitaire permettant d'implémenter la méthode toString() dans votre classe Event personnalisée.
Event
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
Vérifie si preventDefault() a été appelée pour l’événement.
Event
 Inherited
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
 Inherited
Annule le comportement par défaut d’un événement si cette opération est possible.
Event
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d'événements.
Event
 Inherited
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 une chaîne répertoriant toutes les propriétés de l'objet DataChangeEvent.
DataChangeEvent
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
Constantes publiques
 ConstanteDéfini par
 InheritedACTIVATE : String = "activate"
[static] Définit la valeur de la propriété type d'un objet événement activate.
Event
 InheritedADDED : String = "added"
[static] Définit la valeur de la propriété type d'un objet événement added.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[static] Définit la valeur de la propriété type d'un objet événement addedToStage.
Event
 InheritedCANCEL : String = "cancel"
[static] Définit la valeur de la propriété type d'un objet événement cancel.
Event
 InheritedCHANGE : String = "change"
[static] Définit la valeur de la propriété type d'un objet événement change.
Event
 InheritedCLOSE : String = "close"
[static] Définit la valeur de la propriété type d'un objet événement close.
Event
 InheritedCOMPLETE : String = "complete"
[static] Définit la valeur de la propriété type d'un objet événement complete.
Event
 InheritedCONNECT : String = "connect"
[static] Définit la valeur de la propriété type d'un objet événement connect.
Event
  DATA_CHANGE : String = "dataChange"
[static] Définit la valeur de la propriété type d'un objet de l'événement dataChange.
DataChangeEvent
 InheritedDEACTIVATE : String = "deactivate"
[static] Définit la valeur de la propriété type d'un objet événement deactivate.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] Définit la valeur de la propriété type d'un objet événement enterFrame.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[static] Définit la valeur de la propriété type d'un objet événement fullScreen.
Event
 InheritedID3 : String = "id3"
[static] Définit la valeur de la propriété type d'un objet événement id3.
Event
 InheritedINIT : String = "init"
[static] Définit la valeur de la propriété type d'un objet événement init.
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] Définit la valeur de la propriété type d'un objet événement mouseLeave.
Event
 InheritedOPEN : String = "open"
[static] Définit la valeur de la propriété type d'un objet événement open.
Event
  PRE_DATA_CHANGE : String = "preDataChange"
[static] Définit la valeur de la propriété type d'un objet de l'événement preDataChange.
DataChangeEvent
 InheritedREMOVED : String = "removed"
[static] Définit la valeur de la propriété type d'un objet événement removed.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[static] Définit la valeur de la propriété type d'un objet événement removedFromStage.
Event
 InheritedRENDER : String = "render"
[static] Définit la valeur de la propriété type d'un objet événement render.
Event
 InheritedRESIZE : String = "resize"
[static] Définit la valeur de la propriété type d'un objet événement resize.
Event
 InheritedSCROLL : String = "scroll"
[static] Définit la valeur de la propriété type d'un objet événement scroll.
Event
 InheritedSELECT : String = "select"
[static] Définit la valeur de la propriété type d'un objet événement select.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] Définit la valeur de la propriété type d'un objet événement soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] Définit la valeur de la propriété type d'un objet événement tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] Définit la valeur de la propriété type d'un objet événement tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] Définit la valeur de la propriété type d'un objet événement tabIndexChange.
Event
 InheritedUNLOAD : String = "unload"
[static] Définit la valeur de la propriété type d'un objet événement unload.
Event
Détails des propriétés
changeTypepropriété
changeType:String  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.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():String

Voir aussi

endIndexpropriété 
endIndex:uint  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.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():uint

Voir aussi

itemspropriété 
items:Array  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Récupère un tableau contenant les éléments modifiés.


Implémentation
    public function get items():Array
startIndexpropriété 
startIndex:uint  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.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():uint

Voir aussi

Détails du constructeur
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 lecteur : Flash Player 9.0.28.0

Crée un nouvel objet DataChangeEvent avec les paramètres spécifiés.

Paramètres
eventType: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é.
Détails des méthodes
clone()méthode
public override function clone():Event

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.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ée
Event — Nouvel objet DataChangeEvent dont les propriétés ont la même valeur que celles de l’objet d'origine.
toString()méthode 
public override function toString():String

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.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]

Valeur renvoyée
String — Chaîne répertoriant toutes les propriétés de l'objet DataChangeEvent.
Détails de la constante
DATA_CHANGEConstante
public static const DATA_CHANGE:String = "dataChange"

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.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
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
changeTypeIndique le type du changement effectué.
currentTargetObjet qui traite activement l’objet de l'événement avec un écouteur d’événement.
endIndexIdentifie l'index du dernier élément modifié.
itemsTableau qui dresse la liste des éléments modifiés.
startIndexIdentifie l'index du premier élément modifié.
targetObjet qui a diffusé 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.

Voir aussi

PRE_DATA_CHANGEConstante 
public static const PRE_DATA_CHANGE:String = "preDataChange"

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Définit la valeur de la propriété type d'un objet de l'événement preDataChange. Cet objet d'événement est diffusé avant le changement des données du composant.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
changeTypeIndique le type du changement à effectuer.
currentTargetObjet qui traite activement l’objet de l'événement avec un écouteur d’événement.
endIndexIdentifie l'index du dernier élément à modifier.
itemsTableau qui dresse la liste des éléments à modifier.
startIndexIdentifie l'index du premier élément à modifier.
targetObjet qui a diffusé 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.

Voir aussi

Exemples Utilisation des exemples
DataChangeEventExample.as

Cet exemple montre comment demander au DataProvider d'écouter la diffusion de DataChangeEvent et d'utiliser ses événements pour renseigner un DataGrid manuellement.

Pour exécuter l'exemple, procédez comme suit :

  1. Ajoutez les composants DataGrid et Button à la bibliothèque.
  2. Enregistrez ce code sous le nom DataChangeEventExample.as dans le même répertoire que votre fichier FLA.
  3. Dans le fichier FLA, définissez la classe Document sur DataChangeEventExample.
package
{
    import fl.controls.Button;
    import fl.controls.DataGrid;
    import fl.data.DataProvider;
    import fl.events.DataChangeEvent;
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    
    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]);
        }
    }
}




 

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/fl/events/DataChangeEvent.html