Disponibilité

Flash Player 6 (6.0.79.0).

Edition

Flash MX 2004.

Utilisation

on(keyDown){
    ...
}
listenerObject = new Object();
listenerObject.keyDown = function(eventObject){
    ...
}
componentInstance.addEventListener("keyDown", listenerObject)

Description

Evénement : indique aux écouteurs lorsque l'utilisateur appuie sur une touche. Il s'agit d'un événement de très bas niveau que vous devez utiliser uniquement en cas de nécessité car il pourrait avoir une incidence sur les performances du système.

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

Le second exemple d'utilisation fait appel à un modèle d'événement dispatcher/écouteur.
Une occurrence de composant (componentInstance) distribue un événement (dans ce cas, keyDown) qui est géré par une fonction (appelée aussi gestionnaire) sur 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 lorsque l'événement est déclenché. Lorsque cet événement est déclenché, il transmet automatiquement un objet événement (eventObject) à la méthode d'objet écouteur. Chaque objet événement a des propriétés qui contiennent 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.

Exemple

Le code suivant fait clignoter une icône lorsque l'utilisateur appuie sur une touche :

formListener.handleEvent = function(eventObj)
{
    form.icon.visible = !form.icon.visible;
}
form.addEventListener("keyDown", formListener);