Disponibilité

Flash Player 6 (6.0.79.0).

Edition

Flash MX 2004.

Utilisation

Utilisation 1 :

var listenerObject:Object = new Object();
listenerObject.load = function(eventObject:Object) {
    // ...
};
componentInstance.addEventListener("load", listenerObject);

Utilisation 2 :

on (load) {
    //...
}

Description

Evénement : indique aux écouteurs que le sous-objet pour cet objet est en cours de création.

Le premier exemple d'utilisation fait appel à un modèle dispatcher(diffuseur)/écouteur d'événement. Une occurrence de composant (componentInstance) distribue un événement (dans ce cas, load) qui est géré par une fonction (appelée aussi gestionnaire) dans un objet écouteur (listenerObject) que vous créez. Vous définissez une méthode portant le même nom que l'événement traité par l'objet écouteur. La méthode est appelée au déclenchement de l'événement. Lorsqu'il est déclenché, l'événement transmet automatiquement un objet événement (eventObject) à la méthode de l'objet écouteur. Chaque objet événement est doté de propriétés contenant des informations sur l'événement. Vous pouvez utiliser ces propriétés pour écrire le code qui traitera l'événement. Pour finir, vous appelez la méthode EventDispatcher.addEventListener() sur l'occurrence de composant qui diffuse l'événement pour enregistrer l'écouteur avec l'occurrence. Lorsque l'occurrence distribue l'événement, l'écouteur approprié est appelé.

Pour plus d'informations, voir Classe EventDispatcher.

Le second exemple d'utilisation fait appel à un gestionnaire on() et doit être associé directement à une occurrence de composant.

Exemple

L'exemple suivant crée une occurrence de MySymbol une fois que l'occurrence form est chargée :

var formListener:Object = new Object();
formListener.load = function(eventObj:Object) {
    form.createObject("MySymbol", "sym1", 0);
};
form.addEventListener("load", formListener);