Pacchetto | flash.events |
Classe | public class KeyboardEvent |
Ereditarietà | KeyboardEvent Event Object |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
KeyboardEvent.KEY_DOWN
e KeyboardEvent.KEY_UP
Poiché le mappature fra tasti e caratteri specifici possono variare a seconda del dispositivo e del sistema operativo, utilizzate il tipo di evento TextEvent per l'elaborazione dell'input di caratteri.
Per intercettare a livello globale gli eventi di tastiera, usate un listener sullo stage per la fase di cattura, la fase target o quella di bubbling.
Altri esempi
Handling keyboard events
Understanding the keyCode and charCode properties
Understanding KeyboardEvent precedence
Elementi API correlati
Proprietà | Definito da | ||
---|---|---|---|
altKey : Boolean
Indica se il tasto Alt è attivo (true) o inattivo (false) in Windows e se il tasto Opzione è attivo in Mac OS. | KeyboardEvent | ||
bubbles : Boolean [sola lettura]
Indica se un evento è un evento di bubbling. | Event | ||
cancelable : Boolean [sola lettura]
Indica se il comportamento associato all'evento può essere impedito. | Event | ||
charCode : uint
Contiene il valore del codice di carattere del tasto premuto o rilasciato. | KeyboardEvent | ||
commandKey : Boolean
Indica se il tasto Comando è attivo (true) o inattivo (false). | KeyboardEvent | ||
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
controlKey : Boolean
Indica se il tasto Ctrl è attivo (true) o inattivo (false). | KeyboardEvent | ||
ctrlKey : Boolean
In Windows e Linux, indica se il tasto Ctrl è attivo (true) o inattivo (false); in Mac OS, indica se il tasto Ctrl o Comando è attivo. | KeyboardEvent | ||
currentTarget : Object [sola lettura]
L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. | Event | ||
eventPhase : uint [sola lettura]
La fase attuale del flusso di eventi. | Event | ||
keyCode : uint
Il valore del codice tasto del tasto premuto o rilasciato. | KeyboardEvent | ||
keyLocation : uint
Indica la posizione del tasto sulla tastiera. | KeyboardEvent | ||
shiftKey : Boolean
Indica se il tasto Maiusc è attivo (true) o inattivo (false). | KeyboardEvent | ||
target : Object [sola lettura]
Il target dell'evento. | Event | ||
type : String [sola lettura]
Il tipo di evento. | Event |
Metodo | Definito da | ||
---|---|---|---|
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)
Crea un oggetto Event contenente informazioni specifiche sugli eventi di tastiera. | KeyboardEvent | ||
[override]
Crea una copia dell'oggetto KeyboardEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale. | KeyboardEvent | ||
Una funzione dell'utilità per l'implementazione del metodo toString() in classi Event ActionScript 3.0 personalizzate. | Event | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Verifica se sull'evento è stato chiamato il metodo preventDefault(). | Event | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato. | Event | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi. | Event | ||
Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente. | Event | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
[override]
Restituisce una stringa che contiene tutte le proprietà dell'oggetto KeyboardEvent. | KeyboardEvent | ||
Indica di eseguire il rendering della visualizzazione al termine dell'elaborazione dell'evento, se l'elenco di visualizzazione è stato modificato.
| KeyboardEvent | ||
Restituisce il valore di base dell'oggetto specificato. | Object |
Costante | Definito da | ||
---|---|---|---|
KEY_DOWN : String = "keyDown" [statico]
La costante KeyboardEvent.KEY_DOWN definisce il valore della proprietà type di un oggetto evento keyDown. | KeyboardEvent | ||
KEY_UP : String = "keyUp" [statico]
La costante KeyboardEvent.KEY_UP definisce il valore della proprietà type di un oggetto evento keyUp. | KeyboardEvent |
altKey | proprietà |
altKey:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Indica se il tasto Alt è attivo (true
) o inattivo (false
) in Windows e se il tasto Opzione è attivo in Mac OS.
Implementazione
public function get altKey():Boolean
public function set altKey(value:Boolean):void
charCode | proprietà |
charCode:uint
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Contiene il valore del codice di carattere del tasto premuto o rilasciato. I valori dei codici di carattere sono i valori della tastiera inglese. Ad esempio, se premete Maiusc+3, charCode
è # su una tastiera giapponese; se premete Maiusc+2, charCode
è @ su una tastiera tedesca (e non "), come se fosse una tasitera inglese.
Nota: quando è in esecuzione un editor di metodo di input (IME), charCode
non segnala con precisione i codici di carattere.
Implementazione
public function get charCode():uint
public function set charCode(value:uint):void
commandKey | proprietà |
commandKey:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Lite 4 |
Indica se il tasto Comando è attivo (true
) o inattivo (false
). Supportato solo per Mac OS. In Mac OS, la proprietà commandKey
ha lo stesso valore della proprietà ctrlKey
.
Implementazione
public function get commandKey():Boolean
public function set commandKey(value:Boolean):void
controlKey | proprietà |
controlKey:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Lite 4 |
Indica se il tasto Ctrl è attivo (true
) o inattivo (false
). In Windows e Linux, è true anche quando è attivo il tasto Ctrl.
Implementazione
public function get controlKey():Boolean
public function set controlKey(value:Boolean):void
ctrlKey | proprietà |
ctrlKey:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
In Windows e Linux, indica se il tasto Ctrl è attivo (true
) o inattivo (false
); in Mac OS, indica se il tasto Ctrl o Comando è attivo.
Implementazione
public function get ctrlKey():Boolean
public function set ctrlKey(value:Boolean):void
keyCode | proprietà |
keyCode:uint
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Il valore del codice tasto del tasto premuto o rilasciato.
Nota: quando è in esecuzione un editor di metodo di input (IME), keyCode
non segnala con precisione i codici tasto.
Implementazione
public function get keyCode():uint
public function set keyCode(value:uint):void
Elementi API correlati
keyLocation | proprietà |
keyLocation:uint
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indica la posizione del tasto sulla tastiera. Questo è utile per distinguere i tasti che compaiono più di una volta su una tastiera. Ad esempio, è possibile distinguere il tasto Maiusc sinistro da quello destro grazie al valore di questa proprietà: KeyLocation.LEFT
per il tasto sinistro e KeyLocation.RIGHT
per quello destro. Un altro esempio può essere la distinzione tra i tasti numerici premuti sulla tastiera standard (KeyLocation.STANDARD
) e quelli del tastierino numerico (KeyLocation.NUM_PAD
).
Implementazione
public function get keyLocation():uint
public function set keyLocation(value:uint):void
shiftKey | proprietà |
KeyboardEvent | () | Funzione di costruzione |
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)
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea un oggetto Event contenente informazioni specifiche sugli eventi di tastiera. Gli oggetti evento vengono passati ai listener di eventi come parametri.
Parametritype:String — Il tipo di evento. I valori possibili sono: KeyboardEvent.KEY_DOWN e KeyboardEvent.KEY_UP
| |
bubbles:Boolean (default = true ) — Determina se l'oggetto Event partecipa alla fase di bubbling del flusso di eventi.
| |
cancelable:Boolean (default = false ) — Determina se l'oggetto Event può essere annullato.
| |
charCodeValue:uint (default = 0 ) — Il valore del codice di carattere del tasto premuto o rilasciato. I valori dei codici di carattere restituiti sono i valori della tastiera inglese. Se ad esempio premete Maiusc+3 su una tastiera giapponese o tedesca, il metodo Keyboard.charCode() restituisce #, esattamente come su una tastiera inglese.
| |
keyCodeValue:uint (default = 0 ) — Il valore del codice tasto del tasto premuto o rilasciato.
| |
keyLocationValue:uint (default = 0 ) — La posizione del tasto sulla tastiera.
| |
ctrlKeyValue:Boolean (default = false ) — In Windows, indica se il tasto Ctrl è attivato. In Mac, indica se il tasto Ctrl o il tasto Comando è attivato.
| |
altKeyValue:Boolean (default = false ) — Indica se il modificatore del tasto Alt è attivato (solo Windows).
| |
shiftKeyValue:Boolean (default = false ) — Indica se il modificatore del tasto Maiusc è attivato.
| |
controlKeyValue:Boolean (default = false ) — Indica se il tasto Ctrl è attivato in Mac, Windows e Linux.
| |
commandKeyValue:Boolean (default = false ) — Indica se il tasto Comando è attivato (solo Mac).
|
Elementi API correlati
clone | () | metodo |
override public function clone():Event
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea una copia dell'oggetto KeyboardEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.
RestituisceEvent — Un nuovo oggetto KeyboardEvent con proprietà dai valori identici a quelli dell'originale.
|
toString | () | metodo |
override public function toString():String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce una stringa che contiene tutte le proprietà dell'oggetto KeyboardEvent. La stringa ha il seguente formato:
[KeyboardEvent type= valore bubbles= valore cancelable= valore ... shiftKey= valore]
String — Una stringa che contiene tutte le proprietà dell'oggetto KeyboardEvent.
|
updateAfterEvent | () | metodo |
public function updateAfterEvent():void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Indica di eseguire il rendering della visualizzazione al termine dell'elaborazione dell'evento, se l'elenco di visualizzazione è stato modificato.
KEY_DOWN | Costante |
public static const KEY_DOWN:String = "keyDown"
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La costante KeyboardEvent.KEY_DOWN
definisce il valore della proprietà type
di un oggetto evento keyDown
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | true |
cancelable | true in AIR, false in Flash Player; in AIR, l'annullamento di questo evento impedisce l'immissione del carattere in un campo di testo. |
charCode | Il valore del codice di carattere del tasto premuto o rilasciato. |
commandKey | true in Mac se il tasto Comando è attivo. Altrimenti false |
controlKey | true in Windows e Linux se il tasto Ctrl è attivo. true in Mac se il tasto Ctrl è attivo. Altrimenti false |
ctrlKey | true in Windows e Linux se il tasto Ctrl è attivo. true in Mac se il tasto Ctrl o il tasto Comando è attivo. Altrimenti false . |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
keyCode | Il valore del codice tasto del tasto premuto o rilasciato. |
keyLocation | La posizione del tasto sulla tastiera. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
target | L'istanza InteractiveObject attivata. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzate la proprietà currentTarget per accedere all'oggetto dell'elenco di visualizzazione che sta elaborando l'evento. |
Elementi API correlati
KEY_UP | Costante |
public static const KEY_UP:String = "keyUp"
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La costante KeyboardEvent.KEY_UP
definisce il valore della proprietà type
di un oggetto evento keyUp
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | true |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
charCode | Contiene il valore del codice di carattere del tasto premuto o rilasciato. |
commandKey | true in Mac se il tasto Comando è attivo. Altrimenti false |
controlKey | true in Windows e Linux se il tasto Ctrl è attivo. true in Mac se il tasto Ctrl è attivo. Altrimenti false |
ctrlKey | true in Windows se il tasto Ctrl è attivo. true in Mac se il tasto Ctrl o il tasto Comando è attivo. Altrimenti false . |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
keyCode | Il valore del codice tasto del tasto premuto o rilasciato. |
keyLocation | La posizione del tasto sulla tastiera. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
target | L'istanza InteractiveObject attivata. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzate la proprietà currentTarget per accedere all'oggetto dell'elenco di visualizzazione che sta elaborando l'evento. |
Elementi API correlati
KeyboardEventExample
per illustrare gli eventi di tastiera e le relative funzioni del listener. L'esempio esegue le operazioni seguenti:
- Crea una nuova istanza Sprite di nome
child
. - Dichiara le proprietà da utilizzare successivamente nell'impostazione del colore di sfondo e delle dimensioni di un quadrato.
- Utilizzando i metodi di Sprite, disegna un quadrato blu chiaro che viene visualizzato sullo stage in corrispondenza delle coordinate predefinite (0,0) mediante una chiamata al metodo
addChild()
. - Aggiunge un evento associato al mouse e due listener di eventi di tipo keyboard:
click
/clickHandler
che viene inviato quando si fa clic sul quadrato per attivare l'oggetto Spritechild
che deve restare il ascolto di eventi keyboard.keyDown
/keyDownHandler
che viene inviato ogni volta che si preme un tasto. Il metodo subscriber stampa le informazioni relative all'evento utilizzando l'istruzionetrace()
.keyUp
/keyUpHandler
che viene inviato quando si rilascia un tasto.
Quando provate questo esempio, dovete fare prima clic sul quadrato perché gli eventi keyboard funzionino.
Inoltre, se utilizzate il comando Prova filmato in Flash, l'interfaccia di autorizzazione può rispondere ad alcuni tasti anziché ai listener di eventi associati allo sprite secondario.
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); } } }
Tue Jun 12 2018, 02:44 PM Z