ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.events 

KeyboardEvent  - AS3

Paketflash.events
Klassepublic class KeyboardEvent
VererbungKeyboardEvent Inheritance Event Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Ein KeyboardEvent-Objekt wird als Reaktion auf Tastatureingaben des Benutzers ausgelöst. Es gibt zwei Arten von Tastaturereignissen: KeyboardEvent.KEY_DOWN und KeyboardEvent.KEY_UP

Da Zuordnungen zwischen Tasten und spezifischen Zeichen zwischen verschiedenen Geräten und Betriebssystemen variieren, verwenden Sie den Ereignistyp TextEvent für die Verarbeitung von eingegebenen Zeichen.

Um global auf Tastenereignisse zu warten, überwachen Sie die Aufnahme- und Ziel- oder Bubbling-Phase auf der Bühne.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  altKey : Boolean
Gibt unter Windows an, ob die Alt-Taste aktiviert ist (true) oder deaktiviert (false); gibt unter Mac OS an, ob die Wahltaste aktiviert ist.
KeyboardEvent
 Inheritedbubbles : Boolean
[schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
  charCode : uint
Enthält den Zeichencodewert der gedrückten bzw. losgelassenen Taste.
KeyboardEvent
  commandKey : Boolean
Gibt an, ob die Befehlstaste aktiviert (true) oder deaktiviert (false) ist.
KeyboardEvent
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  controlKey : Boolean
Gibt an, ob die Ctrl-Taste aktiviert (true) oder deaktiviert (false) ist.
KeyboardEvent
  ctrlKey : Boolean
Zeigt unter Windows und Linux an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist; zeigt unter Mac OS an, ob die Ctrl-Taste oder die Befehlstaste aktiviert ist.
KeyboardEvent
 InheritedcurrentTarget : Object
[schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
 InheritedeventPhase : uint
[schreibgeschützt] Die aktuelle Phase im Ereignisablauf.
Event
  keyCode : uint
Der Tastencodewert der gedrückten bzw. losgelassenen Taste.
KeyboardEvent
  keyLocation : uint
Gibt die Position der Taste auf der Tastatur an.
KeyboardEvent
  shiftKey : Boolean
Gibt an, ob die Umschalttaste als Zusatztaste aktiviert (true) oder deaktiviert (false) ist.
KeyboardEvent
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
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)
Erstellt ein Ereignisobjekt, das bestimmte Informationen über Tastaturereignisse enthält.
KeyboardEvent
  
[override] Erstellt eine Kopie des KeyboardEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
KeyboardEvent
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.
Event
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.
Event
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
  
[override] Gibt eine Zeichenfolge zurück, die alle Eigenschaften des KeyboardEvent-Objekts enthält.
KeyboardEvent
  
Gibt an, dass die Anzeige nach der Verarbeitung dieses Ereignisses wiedergegeben werden sollte, falls die Anzeigeliste geändert wurde
KeyboardEvent
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
  KEY_DOWN : String = "keyDown"
[statisch] Die KeyboardEvent.KEY_DOWN-Konstante definiert den Wert der type-Eigenschaft eines keyDown-Ereignisobjekts.
KeyboardEvent
  KEY_UP : String = "keyUp"
[statisch] Die KeyboardEvent.KEY_UP-Konstante definiert den Wert der type-Eigenschaft eines keyUp-Ereignisobjekts.
KeyboardEvent
Eigenschaftendetails

altKey

Eigenschaft
altKey:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Gibt unter Windows an, ob die Alt-Taste aktiviert ist (true) oder deaktiviert (false); gibt unter Mac OS an, ob die Wahltaste aktiviert ist.



Implementierung
    public function get altKey():Boolean
    public function set altKey(value:Boolean):void

charCode

Eigenschaft 
charCode:uint

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Enthält den Zeichencodewert der gedrückten bzw. losgelassenen Taste. Die Codewerte sind Werte für die englische Tastatur. Wenn Sie beispielsweise Umschalt+3 drücken, ist charCode # auf einer japanischen Tastatur, wenn Sie Umschalt+2 drücken, ist charCode @ auf einer deutschen Tastatur (und nicht ") wie bei einer englischen Tastatur.

Hinweis: Wenn ein Eingabenmethoden-Editor (Input Method Editor/IME) ausgeführt wird, meldet charCode keine genauen Zeichencodes.



Implementierung
    public function get charCode():uint
    public function set charCode(value:uint):void

commandKey

Eigenschaft 
commandKey:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Lite 4

Gibt an, ob die Befehlstaste aktiviert (true) oder deaktiviert (false) ist. Wird nur unter Mac OS unterstützt. Unter Mac OS hat die commandKey-Eigenschaft denselben Wert wie die ctrlKey-Eigenschaft.



Implementierung
    public function get commandKey():Boolean
    public function set commandKey(value:Boolean):void

controlKey

Eigenschaft 
controlKey:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Lite 4

Gibt an, ob die Ctrl-Taste aktiviert (true) oder deaktiviert (false) ist. Unter Windows und Linux ist dieser Wert auch „true“, wenn die Strg-Taste aktiviert ist.



Implementierung
    public function get controlKey():Boolean
    public function set controlKey(value:Boolean):void

ctrlKey

Eigenschaft 
ctrlKey:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Zeigt unter Windows und Linux an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist; zeigt unter Mac OS an, ob die Ctrl-Taste oder die Befehlstaste aktiviert ist.



Implementierung
    public function get ctrlKey():Boolean
    public function set ctrlKey(value:Boolean):void

keyCode

Eigenschaft 
keyCode:uint

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Der Tastencodewert der gedrückten bzw. losgelassenen Taste.

Hinweis: Wenn ein Eingabenmethoden-Editor (Input Method Editor/IME) ausgeführt wird, meldet keyCode keine genauen Zeichencodes.



Implementierung
    public function get keyCode():uint
    public function set keyCode(value:uint):void

Verwandte API-Elemente

keyLocation

Eigenschaft 
keyLocation:uint

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt die Position der Taste auf der Tastatur an. Dies eignet sich beispielsweise zum Unterscheiden von Tasten, die mehrmals auf einer Tastatur vorhanden sind. Beispielsweise können Sie anhand des Wertes dieser Eigenschaft zwischen der linken und rechten Umschalttaste unterscheiden: KeyLocation.LEFT für die linke und KeyLocation.RIGHT für die rechte Umschalttaste. Ein weiteres Beispiel ist das Unterscheiden zwischen den Zahlentasten auf der Standardtastatur (KeyLocation.STANDARD) und den Zahlentasten im Ziffernblock (KeyLocation.NUM_PAD).



Implementierung
    public function get keyLocation():uint
    public function set keyLocation(value:uint):void

shiftKey

Eigenschaft 
shiftKey:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Gibt an, ob die Umschalttaste als Zusatztaste aktiviert (true) oder deaktiviert (false) ist.



Implementierung
    public function get shiftKey():Boolean
    public function set shiftKey(value:Boolean):void
Konstruktordetails

KeyboardEvent

()Konstruktor
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)

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt ein Ereignisobjekt, das bestimmte Informationen über Tastaturereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.

Parameter
type:String — Der Ereignistyp. Mögliche Werte sind: KeyboardEvent.KEY_DOWN und KeyboardEvent.KEY_UP
 
bubbles:Boolean (default = true) — Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt.
 
cancelable:Boolean (default = false) — Bestimmt, ob das Ereignisobjekt abgebrochen werden kann.
 
charCodeValue:uint (default = 0) — Der Zeichencodewert der gedrückten bzw. losgelassenen Taste. Die zurückgegebenen Codewerte sind Werte für die englische Tastatur. Wenn Sie beispielsweise auf einer japanischen oder deutschen Tastatur Umschalt+3 drücken, gibt Keyboard.charCode() wie auch bei einer englischen Tastatur das Zeichen # zurück.
 
keyCodeValue:uint (default = 0) — Der Tastencodewert der gedrückten bzw. losgelassenen Taste.
 
keyLocationValue:uint (default = 0) — Die Position der Taste auf der Tastatur.
 
ctrlKeyValue:Boolean (default = false) — Unter Windows wird damit angezeigt, ob die Strg-Taste aktiviert ist. Unter Mac OS wird damit angezeigt, ob die Ctrl-Taste oder die Befehlstaste aktiviert ist.
 
altKeyValue:Boolean (default = false) — Gibt an, ob die Alt-Taste als Zusatztaste aktiviert ist (nur Windows).
 
shiftKeyValue:Boolean (default = false) — Gibt an, ob die Umschalttaste als Zusatztaste aktiviert ist.
 
controlKeyValue:Boolean (default = false) — Gibt an, ob unter Mac die Ctrl-Taste oder unter Windows oder Linux die Strg-Taste aktiviert ist.
 
commandKeyValue:Boolean (default = false) — Gibt an, ob die Befehlstaste aktiviert ist (nur Mac).

Verwandte API-Elemente

Methodendetails

clone

()Methode
override public function clone():Event

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt eine Kopie des KeyboardEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.

Rückgabewerte
Event — Ein neues KeyboardEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.

toString

()Methode 
override public function toString():String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt eine Zeichenfolge zurück, die alle Eigenschaften des KeyboardEvent-Objekts enthält. Der String liegt im folgenden Format vor:

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

Rückgabewerte
String — Eine Zeichenfolge, die alle Eigenschaften des KeyboardEvent-Objekts enthält.

updateAfterEvent

()Methode 
public function updateAfterEvent():void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Gibt an, dass die Anzeige nach der Verarbeitung dieses Ereignisses wiedergegeben werden sollte, falls die Anzeigeliste geändert wurde

Konstantendetails

KEY_DOWN

Konstante
public static const KEY_DOWN:String = "keyDown"

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die KeyboardEvent.KEY_DOWN-Konstante definiert den Wert der type-Eigenschaft eines keyDown-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelableWert true in AIR, Wert false in Flash Player; in AIR wird durch Abbrechen dieses Ereignisses verhindert, dass das Zeichen in ein Textfeld eingegeben wird.
charCodeDer Zeichencodewert der gedrückten bzw. losgelassenen Taste.
commandKeytrue unter Mac, wenn die Befehlstaste aktiviert ist. Andernfalls wird false zurückgegeben
controlKeytrue unter Windows und Linux, wenn die Strg-Taste aktiv ist. true unter Mac, wenn die Ctrl-Taste aktiviert ist. Andernfalls wird false zurückgegeben
ctrlKeytrue unter Windows und Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
keyCodeDer Tastencodewert der gedrückten bzw. losgelassenen Taste.
KeyLocationDie Position der Taste auf der Tastatur.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
targetDie InteractiveObject-Instanz mit dem Fokus. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.

Verwandte API-Elemente

KEY_UP

Konstante 
public static const KEY_UP:String = "keyUp"

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die KeyboardEvent.KEY_UP-Konstante definiert den Wert der type-Eigenschaft eines keyUp-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
charCodeEnthält den Zeichencodewert der gedrückten bzw. losgelassenen Taste.
commandKeytrue unter Mac, wenn die Befehlstaste aktiviert ist. Andernfalls wird false zurückgegeben
controlKeytrue unter Windows und Linux, wenn die Strg-Taste aktiv ist. true unter Mac, wenn die Ctrl-Taste aktiviert ist. Andernfalls wird false zurückgegeben
ctrlKeytrue unter Windows, falls die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
keyCodeDer Tastencodewert der gedrückten bzw. losgelassenen Taste.
KeyLocationDie Position der Taste auf der Tastatur.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
targetDie InteractiveObject-Instanz mit dem Fokus. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.

Verwandte API-Elemente

KeyboardEventExample.as

Im folgenden Beispiel werden anhand der Klasse KeyboardEventExample Tastaturereignisse und die zugehörigen Listener-Funktionen erläutert. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
  1. Die neue Sprite-Instanz child wird erstellt.
  2. Es werden Eigenschaften für die spätere Verwendung bei der Festlegung von Farbe und Größe eines Quadrats deklariert.
  3. Mithilfe von Sprite-Methoden wird ein hellblaues Quadrat gezeichnet, das unter Zuhilfenahme der addChild()-Methode mit den Standardkoordinaten (0,0) auf der Bühne dargestellt wird.
  4. Es werden ein Mausereignis und zwei Tastaturereignisse hinzugefügt:
    • click/clickHandler, das ausgelöst wird, wenn Sie auf das Quadrat klicken, um den Fokus auf das child-Sprite zu verlagern, damit es auf Tastaturereignisse warten kann.
    • keyDown/keyDownHandler wird bei jedem Tastendruck ausgelöst. Die Abonnentenmethode druckt Informationen zum Ereignis mithilfe der trace()-Anweisung.
    • keyUp/keyUpHandler wird bei jedem Loslassen einer Taste ausgelöst.

Wenn Sie dieses Beispiel testen, müssen Sie zunächst auf das Quadrat klicken, damit das Tastaturereignis funktioniert.

Wenn Sie in Flash den Befehl „Film testen“ verwenden, reagiert möglicherweise die Authoring-Oberfläche anstelle des Ereignis-Listeners am child-Sprite auf bestimmte Tasten.

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




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.