Pacchettoflash.events
Classepublic class KeyboardEvent
EreditarietàKeyboardEvent Inheritance Event Inheritance Object

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Flash® Player invia oggetti KeyboardEvent in risposta all'input da tastiera dell'utente. Esistono due tipi di eventi associati alla tastiera: 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, utilizzare il tipo di evento TextEvent per l'elaborazione dell'input di caratteri.

Per intercettare a livello globale gli eventi di tastiera, rilevare sullo stage la fase di cattura, la fase target o quella di bubbling.

Vedere gli esempi

Vedere anche

KEY_DOWN
KEY_UP
KeyLocation


Proprietà pubbliche
 ProprietàDefinito da
  altKey: Boolean
Indica se il tasto Alt è attivo (true) o inattivo (false).
KeyboardEvent
 Inheritedbubbles: Boolean
[sola lettura] Indica se un evento è un evento di bubbling.
Event
 Inheritedcancelable: 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
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  ctrlKey: Boolean
Indica se il tasto Ctrl è attivo (true) o inattivo (false).
KeyboardEvent
 InheritedcurrentTarget: Object
[sola lettura] L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
Event
 InheritedeventPhase: 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
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
  shiftKey: Boolean
Indica se il tasto Maiusc è attivo (true) o inattivo (false).
KeyboardEvent
 Inheritedtarget: Object
[sola lettura] Il target dell'evento.
Event
 Inheritedtype: String
[sola lettura] Il tipo di evento.
Event
Metodi pubblici
 MetodoDefinito da
  
KeyboardEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, charCode:uint = 0, keyCode:uint = 0, keyLocation:uint = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false)
Crea un oggetto Event contenente informazioni specifiche sugli eventi di tastiera.
KeyboardEvent
  
Crea una copia dell'oggetto KeyboardEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.
KeyboardEvent
 Inherited
formatToString(className:String, ... arguments):String
Una funzione di utilità per l'implementazione del metodo toString() nella classe Event personalizzata.
Event
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Verifica se sull'evento è stato chiamato il metodo preventDefault().
Event
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato.
Event
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi.
Event
 Inherited
Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente.
Event
  
Restituisce una stringa che contiene tutte le proprietà dell'oggetto KeyboardEvent.
KeyboardEvent
  
Indica a Flash Player di eseguire il rendering al termine dell'elaborazione dell'evento se l'elenco di visualizzazione è stato modificato.
KeyboardEvent
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Costanti pubbliche
 CostanteDefinito da
 InheritedACTIVATE: String = "activate"
[statico] Definisce il valore della proprietà type di un oggetto evento activate.
Event
 InheritedADDED: String = "added"
[statico] Definisce il valore della proprietà type di un oggetto evento added.
Event
 InheritedADDED_TO_STAGE: String = "addedToStage"
[statico] Definisce il valore della proprietà type di un oggetto evento addedToStage.
Event
 InheritedCANCEL: String = "cancel"
[statico] Definisce il valore della proprietà type di un oggetto evento cancel.
Event
 InheritedCHANGE: String = "change"
[statico] Definisce il valore della proprietà type di un oggetto evento change.
Event
 InheritedCLOSE: String = "close"
[statico] Definisce il valore della proprietà type di un oggetto evento close.
Event
 InheritedCOMPLETE: String = "complete"
[statico] Definisce il valore della proprietà type di un oggetto evento complete.
Event
 InheritedCONNECT: String = "connect"
[statico] Definisce il valore della proprietà type di un oggetto evento connect.
Event
 InheritedDEACTIVATE: String = "deactivate"
[statico] Definisce il valore della proprietà type di un oggetto evento deactivate.
Event
 InheritedENTER_FRAME: String = "enterFrame"
[statico] Definisce il valore della proprietà type di un oggetto evento enterFrame.
Event
 InheritedFULLSCREEN: String = "fullScreen"
[statico] Definisce il valore della proprietà type di un oggetto evento fullScreen.
Event
 InheritedID3: String = "id3"
[statico] Definisce il valore della proprietà type di un oggetto evento id3.
Event
 InheritedINIT: String = "init"
[statico] Definisce il valore della proprietà type di un oggetto evento init.
Event
  KEY_DOWN: String = "keyDown"
[statico] Definisce il valore della proprietà type di un oggetto evento keyDown.
KeyboardEvent
  KEY_UP: String = "keyUp"
[statico] Definisce il valore della proprietà type di un oggetto evento keyUp.
KeyboardEvent
 InheritedMOUSE_LEAVE: String = "mouseLeave"
[statico] Definisce il valore della proprietà type di un oggetto evento mouseLeave.
Event
 InheritedOPEN: String = "open"
[statico] Definisce il valore della proprietà type di un oggetto evento open.
Event
 InheritedREMOVED: String = "removed"
[statico] Definisce il valore della proprietà type di un oggetto evento removed.
Event
 InheritedREMOVED_FROM_STAGE: String = "removedFromStage"
[statico] Definisce il valore della proprietà type di un oggetto evento removedFromStage.
Event
 InheritedRENDER: String = "render"
[statico] Definisce il valore della proprietà type di un oggetto evento render.
Event
 InheritedRESIZE: String = "resize"
[statico] Definisce il valore della proprietà type di un oggetto evento resize.
Event
 InheritedSCROLL: String = "scroll"
[statico] Definisce il valore della proprietà type di un oggetto evento scroll.
Event
 InheritedSELECT: String = "select"
[statico] Definisce il valore della proprietà type di un oggetto evento select.
Event
 InheritedSOUND_COMPLETE: String = "soundComplete"
[statico] Definisce il valore della proprietà type di un oggetto evento soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE: String = "tabChildrenChange"
[statico] Definisce il valore della proprietà type di un oggetto evento tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE: String = "tabEnabledChange"
[statico] Definisce il valore della proprietà type di un oggetto evento tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE: String = "tabIndexChange"
[statico] Definisce il valore della proprietà type di un oggetto evento tabIndexChange.
Event
 InheritedUNLOAD: String = "unload"
[statico] Definisce il valore della proprietà type di un oggetto evento unload.
Event
Descrizione delle proprietà
altKeyproprietà
altKey:Boolean  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il tasto Alt è attivo (true) o inattivo (false). Supportato solo per il sistema operativo Windows.


Implementazione
    public function get altKey():Boolean
    public function set altKey(value:Boolean):void
charCodeproprietà 
charCode:uint  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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 si preme Maiusc+3 su una tastiera giapponese, charCode restituisce #, esattamente come accade su una tastiera 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

Vedere anche

ctrlKeyproprietà 
ctrlKey:Boolean  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il tasto Ctrl è attivo (true) o inattivo (false).

Nota: il modificatore del tasto Comando sui sistemi Macintosh deve essere rappresentato mediante questo modificatore di tasto.


Implementazione
    public function get ctrlKey():Boolean
    public function set ctrlKey(value:Boolean):void
keyCodeproprietà 
keyCode:uint  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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

Vedere anche

keyLocationproprietà 
keyLocation:uint  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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
shiftKeyproprietà 
shiftKey:Boolean  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il tasto Maiusc è attivo (true) o inattivo (false).


Implementazione
    public function get shiftKey():Boolean
    public function set shiftKey(value:Boolean):void
Descrizione della funzione di costruzione
KeyboardEvent()Funzione di costruzione
public function KeyboardEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, charCode:uint = 0, keyCode:uint = 0, keyLocation:uint = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false)

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea un oggetto Event contenente informazioni specifiche sugli eventi di tastiera. Gli oggetti evento vengono passati ai listener di eventi come parametri.

Parametri
type: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.
 
charCode: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. Ad esempio, se si preme Maiusc+3 su una tastiera giapponese, il metodo getASCIICode() restituisce #, esattamente come accade su una tastiera inglese.
 
keyCode:uint (default = 0) — Il valore del codice tasto del tasto premuto o rilasciato.
 
keyLocation:uint (default = 0) — La posizione del tasto sulla tastiera.
 
ctrlKey:Boolean (default = false) — Indica se il modificatore del tasto Ctrl è attivato.
 
altKey:Boolean (default = false) — Indica se il modificatore del tasto Alt è attivato (solo Windows).
 
shiftKey:Boolean (default = false) — Indica se il modificatore del tasto Maiusc è attivato.

Vedere anche

Descrizione dei metodi
clone()metodo
public override function clone():Event

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea una copia dell'oggetto KeyboardEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.

Restituisce
Event — Un nuovo oggetto KeyboardEvent con proprietà dai valori identici a quelli dell'originale.
toString()metodo 
public override function toString():String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Restituisce una stringa che contiene tutte le proprietà dell'oggetto KeyboardEvent. La stringa ha il seguente formato:

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

Restituisce
String — Una stringa che contiene tutte le proprietà dell'oggetto KeyboardEvent.
updateAfterEvent()metodo 
public function updateAfterEvent():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica a Flash Player di eseguire il rendering al termine dell'elaborazione dell'evento se l'elenco di visualizzazione è stato modificato.

Descrizione delle costanti
KEY_DOWNCostante
public static const KEY_DOWN:String = "keyDown"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento keyDown.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblestrue
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
charCodeIl valore del codice di carattere del tasto premuto o rilasciato.
ctrlKeytrue se il tasto Ctrl è attivo; false se è inattivo.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
keyCodeIl valore del codice tasto del tasto premuto o rilasciato.
keyLocationLa posizione del tasto sulla tastiera.
shiftKeytrue se il tasto Maiusc è attivo; false se è inattivo.
targetL'istanza InteractiveObject attivata. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

KEY_UPCostante 
public static const KEY_UP:String = "keyUp"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento keyUp.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblestrue
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
charCodeContiene il valore del codice di carattere del tasto premuto o rilasciato.
ctrlKeytrue se il tasto Ctrl è attivo; false se è inattivo.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
keyCodeIl valore del codice tasto del tasto premuto o rilasciato.
keyLocationLa posizione del tasto sulla tastiera.
shiftKeytrue se il tasto Maiusc è attivo; false se è inattivo.
targetL'istanza InteractiveObject attivata. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

Esempi Come utilizzare gli esempi
KeyboardEventExample.as

Nell'esempio seguente viene utilizzata la classe KeyboardEventExample per illustrare gli eventi di tastiera e le relative funzioni del listener. L'esempio esegue le operazioni seguenti:
  1. Dichiara le proprietà da utilizzare successivamente nell'impostazione del colore di sfondo e delle dimensioni di un quadrato.
  2. Crea una nuova istanza Sprite di nome child.
  3. 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().
  4. Aggiunge due listener di eventi di tipo tastiera:
    • keyDown / keyDownHandler che viene inviato ogni volta che si preme un tasto. Il metodo subscriber stampa le informazioni relative all'evento utilizzando l'istruzione trace().
    • keyUp / keyUpHandler che viene inviato quando si rilascia un tasto.

In alcuni casi, può essere necessario fare clic sullo stage per consentire il funzionamento degli eventi di tastiera.

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

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

        public function KeyboardEventExample() {
            var child:Sprite = new Sprite();
            child.graphics.beginFill(bgColor);
            child.graphics.drawRect(0, 0, size, size);
            child.graphics.endFill();
            addChild(child);
            stage.focus = child;
            child.addEventListener(KeyboardEvent.KEY_DOWN, keyDownHandler);
            child.addEventListener(KeyboardEvent.KEY_UP, keyUpHandler);
        }

        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);
        }
    }
}




 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/events/KeyboardEvent.html