KeyboardEvent  - AS3

Indique si la touche Alt est activée (true) ou non (false) sur Windows ; indique si la touche Option est activée sur Mac OS.

Contient la valeur du code de caractère associé à la touche enfoncée ou relâchée. Les valeurs renvoyées sont celles du clavier anglais. Par exemple, si vous appuyez sur Maj+3, le caractère charCode correspondant est # sur un clavier japonais, si vous appuyez sur Maj+2, le caractère charCode est @ sur un clavier allemand (et non pas "), comme c’est le cas sur un clavier anglais.

Remarque : Lorsqu’un éditeur IME (Input Method Editor) est en cours d’exécution, les codes de caractères renvoyés par charCode sont incorrects.

Indique si la touche Command est activée (true) ou non (false). Pris en charge pour Mac OS uniquement. Sur Mac OS, la propriété commandKey a la même valeur que la propriété ctrlKey.

Indique si la touche Ctrl est activée (true) ou non (false). Sous Windows et Linux, cette propriété est également true lorsque la touche Ctrl est activée.

Sous Windows et Linux, indique si la touche Ctrl est activée (true) ou non (false) ; sous Mac OS, indique si la touche Ctrl ou Commande est activée.

Valeur de code correspondant à la touche enfoncée ou relâchée.

Remarque : lorsqu’un éditeur IME (Input Method Editor) est en cours d’exécution, les codes de caractères renvoyés par keyCode sont incorrects.

Eléments de l’API associés

Emplacement de la touche sur le clavier. Cette propriété vous permet de différencier des touches qui figurent plusieurs fois sur un clavier. Sa valeur vous permet par exemple de faire la différence entre les touches Maj de gauche et de droite : KeyLocation.LEFT représente la touche de gauche et KeyLocation.RIGHT celle de droite. Vous pouvez aussi, par exemple distinguer les touches numériques du clavier standard (KeyLocation.STANDARD) de celles du pavé numérique (KeyLocation.NUM_PAD).

Indique si la touche de modification Maj est activée (true) ou non (false).

Crée un objet Event contenant des informations spécifiques sur les événements clavier. Les objets Event sont transmis en tant que paramètres aux écouteurs d’événements.

Eléments de l’API associés

Crée une copie de l’objet KeyboardEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine.

Renvoie une chaîne répertoriant toutes les propriétés de l’objet KeyboardEvent. La chaîne est écrite au format suivant :

[KeyboardEvent type=valeur bubbles=valeur cancelable=valeur ... shiftKey=valeur]

Indique que l’affichage doit être rendu à la fin du traitement de cet événement, si la liste d’affichage a été modifiée

La constante KeyboardEvent.KEY_DOWN définit la valeur de la propriété type d’un objet événement keyDown.

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

Eléments de l’API associés

La constante KeyboardEvent.KEY_UP définit la valeur de la propriété type d’un objet d’événement keyUp.

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

Eléments de l’API associés

1. Il créé une nouvelle occurrence de Sprite nommée child.
2. Il déclare les propriétés à utiliser pour paramétrer la taille et la couleur d’arrière-plan d’un carré.
3. A l’aide des méthodes de Sprite, il trace un carré bleu clair qui apparaît sur la scène aux coordonnées par défaut (0,0) en appelant à méthode addChild().
4. Il ajoute un événement mouse et deux écouteurs d’événements de type keyboard :
   • click/clickHandler qui est distribué lorsque vous cliquez sur le carré pour définir le focus sur le sprite child de façon à ce qu’il puisse écouter des événements keyboard.
   • keyDown / keyDownHandler distribué à chaque appui de l’utilisateur sur une touche. La méthode d’abonné imprime des informations sur l’événement à l’aide de l’instruction trace().
   • keyUp / keyUpHandler distribué chaque fois que l’utilisateur relâche une touche.

Lorsque vous testez cet exemple, vous devez cliquer sur le carré d’abord pour que les événements keyboard fonctionnent.

De plus, si vous utilisez la commande Test Movie dans Flash, l’interface de programmation peut répondre à certaines touches au lieu des écouteurs d’événements associés au sprite enfant.

package {
    import flash.display.Sprite;
    import flash.display.DisplayObject;
    import flash.events.*;

    public class KeyboardEventExample extends Sprite {
        private var child:Sprite = new Sprite();
        private var bgColor:uint = 0x00CCFF;
        private var size:uint = 80;

        public function KeyboardEventExample() {
            child.graphics.beginFill(bgColor);
            child.graphics.drawRect(0, 0, size, size);
            child.graphics.endFill();
            addChild(child);
            child.addEventListener(MouseEvent.CLICK, clickHandler);
            child.addEventListener(KeyboardEvent.KEY_DOWN, keyDownHandler);
            child.addEventListener(KeyboardEvent.KEY_UP, keyUpHandler);
            
        }

        private function clickHandler(event:MouseEvent):void {
            stage.focus = child;
        }

        private function keyDownHandler(event:KeyboardEvent):void {
            trace("keyDownHandler: " + event.keyCode);
            trace("ctrlKey: " + event.ctrlKey);
            trace("keyLocation: " + event.keyLocation);
            trace("shiftKey: " + event.shiftKey);
            trace("altKey: " + event.altKey);

        }

        private function keyUpHandler(event:KeyboardEvent):void {
            trace("keyUpHandler: " + event.keyCode);
        }
        
        
    }
}