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():String
Elé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():uint
Elé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():uint
Elé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