| Package | flash.events |
| Classe | public class KeyboardEvent |
| Héritage | KeyboardEvent Event Object |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
KeyboardEvent.KEY_DOWN et KeyboardEvent.KEY_UP
Les correspondances entre les touches et des caractères spécifiques sont fonction du périphérique et du système d'exploitation de l'utilisateur. Choisissez donc le type d'événement TextEvent pour traiter les saisies de caractères.
Pour écouter globalement les événements de touche, écoutez, sur la scène, la phase de capture et la phase cible ou la phase de propagation vers le haut (bubbling).
Voir aussi
| Propriété | Défini par | ||
|---|---|---|---|
| altKey : Boolean 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. | KeyboardEvent | ||
![]() | 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 annulé. | Event | |
| charCode : uint Contient la valeur du code de caractère associé à la touche enfoncée ou relâchée. | KeyboardEvent | ||
Indique si la touche Command est activée (true) ou non (false). | KeyboardEvent | ||
![]() | constructor : Object Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet. | Object | |
Indique si la touche Ctrl est activée (true) ou non (false). | KeyboardEvent | ||
| ctrlKey : Boolean 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. | KeyboardEvent | ||
![]() | currentTarget : Object [lecture seule] L'objet qui traite activement l'objet Event avec un écouteur d'événements. | Event | |
![]() | eventPhase : uint [lecture seule] Phase actuelle du flux d'événements. | Event | |
| keyCode : uint Valeur de code correspondant à la touche enfoncée ou relâchée. | KeyboardEvent | ||
| keyLocation : uint Emplacement de la touche sur le clavier. | KeyboardEvent | ||
![]() | prototype : Object [statique] Référence à l'objet prototype d'un objet de classe ou fonction. | Object | |
| shiftKey : Boolean Indique si la touche Maj de modification est activée (true) ou non (false). | KeyboardEvent | ||
![]() | target : Object [lecture seule] Cible de l'événement. | Event | |
![]() | type : String [lecture seule] Type d'événement. | Event | |
| Méthode | Défini par | ||
|---|---|---|---|
KeyboardEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, charCodeValue:uint = 0, keyCodeValue:uint = 0, keyLocationValue:uint = 0, ctrlKeyValue:Boolean = false, altKeyValue:Boolean = false, shiftKeyValue:Boolean = false, controlKeyValue:Boolean = false, commandKeyValue:Boolean = false) Crée un objet Event contenant des informations spécifiques sur les événements clavier. | KeyboardEvent | ||
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. | KeyboardEvent | ||
![]() | 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 une chaîne répertoriant toutes les propriétés de l'objet KeyboardEvent. | KeyboardEvent | ||
Indique que l'affichage doit être rendu à la fin du traitement de cet événement, si la liste d'affichage a été modifiée | KeyboardEvent | ||
![]() | Renvoie la valeur primitive de l'objet spécifié. | Object | |
| Constante | Défini par | ||
|---|---|---|---|
![]() | ACTIVATE : String = "activate" [statique] La constante ACTIVATE définit la valeur de la propriété type d'un objet événement activate. | Event | |
![]() | ADDED : String = "added" [statique] La constante Event.ADDED définit la valeur de la propriété type d'un objet événement added. | Event | |
![]() | ADDED_TO_STAGE : String = "addedToStage" [statique] La constante Event.ADDED_TO_STAGE définit la valeur de la propriété type d'un objet d'événement addedToStage. | Event | |
![]() | CANCEL : String = "cancel" [statique] La constante Event.CANCEL définit la valeur de la propriété type d'un objet événement cancel. | Event | |
![]() | CHANGE : String = "change" [statique] La constante Event.CHANGE définit la valeur de la propriété type de l'objet d'événement change. | Event | |
![]() | CLEAR : String = "clear" [statique] La constante Event.CLEAR définit la valeur de la propriété type d'un objet événement clear. | Event | |
![]() | CLOSE : String = "close" [statique] La constante Event.CLOSE définit la valeur de la propriété type d'un objet événement close. | Event | |
![]() | [statique] La constante Event.CLOSING définit la valeur de la propriété type d'un objet événement closing. | Event | |
![]() | COMPLETE : String = "complete" [statique] La constante Event.COMPLETE définit la valeur de la propriété type d'un objet événement complete. | Event | |
![]() | CONNECT : String = "connect" [statique] La constante Event.CONNECT définit la valeur de la propriété type d'un objet événement connect. | Event | |
![]() | COPY : String = "copy" [statique] Définit la valeur de la propriété type d'un objet d'événement copy. | Event | |
![]() | CUT : String = "cut" [statique] Définit la valeur de la propriété type d'un objet d'événement cut. | Event | |
![]() | DEACTIVATE : String = "deactivate" [statique] La constante Event.DEACTIVATE définit la valeur de la propriété type d'un objet événement deactivate. | Event | |
![]() | DISPLAYING : String = "displaying" [statique] La constante Event.DISPLAYING définit la valeur de la propriété type d'un objet événement displaying. | Event | |
![]() | ENTER_FRAME : String = "enterFrame" [statique] La constante Event.ENTER_FRAME définit la valeur de la propriété type d'un objet événement enterFrame. | Event | |
![]() | EXIT_FRAME : String = "exitFrame" [statique] La constante Event.EXIT_FRAME définit la valeur de la propriété type d'un objet événement exitFrame. | Event | |
![]() | [statique] La constante Event.EXITING définit la valeur de la propriété type de l'objet d'événement exiting. | Event | |
![]() | FRAME_CONSTRUCTED : String = "frameConstructed" [statique] La constante Event.FRAME_CONSTRUCTED définit la valeur de la propriété type d'un objet événement frameConstructed. | Event | |
![]() | FULLSCREEN : String = "fullScreen" [statique] La constante Event.FULL_SCREEN définit la valeur de la propriété type d'un objet événement fullScreen. | Event | |
![]() | [statique] La constante Event.HTML_BOUNDS_CHANGE définit la valeur de la propriété type d'un objet événement htmlBoundsChange. | Event | |
![]() | [statique] La constante Event.HTML_DOM_INITIALIZE définit la valeur de la propriété type d'un objet événement htmlDOMInitialize. | Event | |
![]() | [statique] La constante Event.HTML_RENDER définit la valeur de la propriété type d'un objet événement htmlRender. | Event | |
![]() | ID3 : String = "id3" [statique] La constante Event.ID3 définit la valeur de la propriété type d'un objet événement id3. | Event | |
![]() | INIT : String = "init" [statique] La constante Event.INIT définit la valeur de la propriété type d'un objet événement init. | Event | |
| KEY_DOWN : String = "keyDown" [statique] Définit la valeur de la propriété type d'un objet événement keyDown. | KeyboardEvent | ||
| KEY_UP : String = "keyUp" [statique] Définit la valeur de la propriété type d'un objet événement keyUp. | KeyboardEvent | ||
![]() | [statique] La constante Event.LOCATION_CHANGE définit la valeur de la propriété type d'un objet événement locationChange. | Event | |
![]() | MOUSE_LEAVE : String = "mouseLeave" [statique] La constante Event.MOUSE_LEAVE définit la valeur de la propriété type d'un objet événement mouseLeave. | Event | |
![]() | [statique] La constante Event.NETWORK_CHANGE définit la valeur de la propriété type d'un objet événement networkChange. | Event | |
![]() | OPEN : String = "open" [statique] La constante Event.OPEN définit la valeur de la propriété type d'un objet événement open. | Event | |
![]() | PASTE : String = "paste" [statique] La constante Event.PASTE définit la valeur de la propriété type d'un objet événement paste. | Event | |
![]() | REMOVED : String = "removed" [statique] La constante Event.REMOVED définit la valeur de la propriété type d'un objet événement removed. | Event | |
![]() | REMOVED_FROM_STAGE : String = "removedFromStage" [statique] La constante Event.REMOVED_FROM_STAGE définit la valeur de la propriété type d'un objet événement removedFromStage. | Event | |
![]() | RENDER : String = "render" [statique] La constante Event.RENDER définit la valeur de la propriété type d'un objet événement render. | Event | |
![]() | RESIZE : String = "resize" [statique] La constante Event.RESIZE définit la valeur de la propriété type d'un objet événement resize. | Event | |
![]() | SCROLL : String = "scroll" [statique] La constante Event.SCROLL définit la valeur de la propriété type d'un objet événement scroll. | Event | |
![]() | SELECT : String = "select" [statique] La constante Event.SELECT définit la valeur de la propriété type d'un objet événement select. | Event | |
![]() | SELECT_ALL : String = "selectAll" [statique] La constante Event.SELECT_ALL définit la valeur de la propriété type d'un objet événement selectAll. | Event | |
![]() | SOUND_COMPLETE : String = "soundComplete" [statique] La constante Event.SOUND_COMPLETE définit la valeur de la propriété type d'un objet événement soundComplete. | Event | |
![]() | TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [statique] La constante Event.TAB_CHILDREN_CHANGE définit la valeur de la propriété type d'un objet événement tabChildrenChange. | Event | |
![]() | TAB_ENABLED_CHANGE : String = "tabEnabledChange" [statique] La constante Event.TAB_ENABLED_CHANGE définit la valeur de la propriété type d'un objet événement tabEnabledChange. | Event | |
![]() | TAB_INDEX_CHANGE : String = "tabIndexChange" [statique] La constante Event.TAB_INDEX_CHANGE définit la valeur de la propriété type d'un objet événement tabIndexChange. | Event | |
![]() | UNLOAD : String = "unload" [statique] La constante Event.UNLOAD définit la valeur de la propriété type d'un objet événement unload. | Event | |
![]() | [statique] La constante Event.USER_IDLE définit la valeur de la propriété type d'un objet événement userIdle. | Event | |
![]() | [statique] La constante Event.USER_PRESENT définit la valeur de la propriété type d'un objet événement userPresent. | Event | |
| altKey | propriété |
altKey:Boolean [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
public function get altKey():Boolean public function set altKey(value:Boolean):void| charCode | propriété |
charCode:uint [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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. Si vous appuyez sur Maj + 3, par exemple, la méthode charCode renvoie # sur un clavier japonais, comme 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.
public function get charCode():uint public function set charCode(value:uint):voidVoir aussi
| propriété |
commandKey:Boolean [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 |
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.
public function get commandKey():Boolean public function set commandKey(value:Boolean):void| propriété |
controlKey:Boolean [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 |
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.
public function get controlKey():Boolean public function set controlKey(value:Boolean):void| ctrlKey | propriété |
ctrlKey:Boolean [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
public function get ctrlKey():Boolean public function set ctrlKey(value:Boolean):void| keyCode | propriété |
keyCode:uint [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
public function get keyCode():uint public function set keyCode(value:uint):voidVoir aussi
| keyLocation | propriété |
keyLocation:uint [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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 ).
public function get keyLocation():uint public function set keyLocation(value:uint):void| shiftKey | propriété |
shiftKey:Boolean [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Indique si la touche de modification Maj est activée (true) ou non (false ).
public function get shiftKey():Boolean public function set shiftKey(value:Boolean):void| KeyboardEvent | () | Constructeur |
public function KeyboardEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, charCodeValue:uint = 0, keyCodeValue:uint = 0, keyLocationValue:uint = 0, ctrlKeyValue:Boolean = false, altKeyValue:Boolean = false, shiftKeyValue:Boolean = false, controlKeyValue:Boolean = false, commandKeyValue:Boolean = false)| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
Paramètrestype:String —
Type de l'événement. Les valeurs possibles sont les suivantes : KeyboardEvent.KEY_DOWN et KeyboardEvent.KEY_UP
| |
bubbles:Boolean (default = true) — Détermine si l'objet Event prend part à la phase de propagation vers le haut (bubbling) du flux d'événements. | |
cancelable:Boolean (default = false) — Détermine si l'objet Event peut être annulé. | |
charCodeValue:uint (default = 0) —
Valeur du code de caractère associé à la touche enfoncée ou relâchée. Les valeurs renvoyées sont des valeurs du clavier anglais. Si vous appuyez sur Maj + 3, par exemple, la méthode getASCIICode() renvoie # sur un clavier japonais, ce qui correspond à ce qu'elle renvoie sur un clavier anglais.
| |
keyCodeValue:uint (default = 0) — Valeur de code correspondant à la touche enfoncée ou relâchée. | |
keyLocationValue:uint (default = 0) — Emplacement de la touche sur le clavier. | |
ctrlKeyValue:Boolean (default = false) — Sur Windows, indique si la touche Ctrl est activée. Sur Mac, indique si la touche Ctrl ou la touche Commande est activée. | |
altKeyValue:Boolean (default = false) — Indique si la touche de modification Alt est activée (Windows uniquement). | |
shiftKeyValue:Boolean (default = false) — Indique si la touche de modification Maj est activée. | |
controlKeyValue:Boolean (default = false) — Indique si la touche Contrôle et activée sous Mac, et si la touche Ctrl ou Contrôle est activée sous Windows et Linux. | |
commandKeyValue:Boolean (default = false) — Indique si la touche Commande est activée (Mac uniquement). |
Voir aussi
| clone | () | méthode |
override public function clone():Event| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
Valeur renvoyéeEvent — Nouvel objet KeyboardEvent 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 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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 ]
String — Chaîne répertoriant toutes les propriétés de l'objet KeyboardEvent. |
| updateAfterEvent | () | méthode |
public function updateAfterEvent():void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Indique que l'affichage doit être rendu à la fin du traitement de cet événement, si la liste d'affichage a été modifiée
| KEY_DOWN | Constante |
public static const KEY_DOWN:String = "keyDown"| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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 :
| Propriété | Valeur |
|---|---|
bubbles
|
true
|
cancelable
|
false ; il n'existe aucun comportement par défaut à annuler.
|
charCode
| Valeur du code de caractère associé à la touche enfoncée ou relâchée. |
commandKey
|
true sous Mac si la touche Commande est activée. Autrement, false
|
controlKey
|
true sous Windows et Linux si la touche Ctrl est activée. true sous Mac si la touche Contrôle est activée. Autrement, false
|
ctrlKey
|
true sous Windows et Linux si la touche Ctrl est activée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Autrement, false.
|
currentTarget
| L'objet qui traite activement l'objet Event avec un écouteur d'événements. |
keyCode
| Valeur de code correspondant à la touche enfoncée ou relâchée. |
keyLocation
| Emplacement de la touche sur le clavier. |
shiftKey
|
true si la touche Maj est activée ; false si elle ne l'est pas.
|
target
|
Occurrence d'InteractiveObject possédant le focus. La propriété target ne correspond pas toujours à l'objet de la liste d'affichage qui est associé à l'écouteur d'événement. Utilisez la propriété currentTarget pour accéder à l'objet de la liste d'affichage qui traite actuellement l'événement.
|
Voir aussi
| KEY_UP | Constante |
public static const KEY_UP:String = "keyUp"| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Définit la valeur de la propriété type d'un objet événement keyUp.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles
|
true
|
cancelable
|
false ; il n'existe aucun comportement par défaut à annuler.
|
charCode
| Contient la valeur du code de caractère associé à la touche enfoncée ou relâchée. |
commandKey
|
true sous Mac si la touche Commande est activée. Autrement, false
|
controlKey
|
true sous Windows et Linux si la touche Ctrl est activée. true sous Mac si la touche Contrôle est activée. Autrement, false
|
ctrlKey
|
true sur Windows si la touche Ctrl est enfoncée. true sur Mac si la touche Ctrl ou la touche Commande est activée. Autrement, false.
|
currentTarget
| L'objet qui traite activement l'objet Event avec un écouteur d'événements. |
keyCode
| Valeur de code correspondant à la touche enfoncée ou relâchée. |
keyLocation
| Emplacement de la touche sur le clavier. |
shiftKey
|
true si la touche Maj est activée ; false si elle ne l'est pas.
|
target
|
Occurrence d'InteractiveObject possédant le focus. La propriété target ne correspond pas toujours à l'objet de la liste d'affichage qui est associé à l'écouteur d'événement. Utilisez la propriété currentTarget pour accéder à l'objet de la liste d'affichage qui traite actuellement l'événement.
|
Voir aussi
KeyboardEventExample pour montrer les événements clavier et leurs fonctions d'écouteur. L'exemple exécute les tâches suivantes :
child.
addChild().
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.
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);
}
}
}