Paketflash.events
Klassepublic class KeyboardEvent
VererbungKeyboardEvent Inheritance Event Inheritance Object

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Flash® Player löst KeyboardEvent-Objekte aus, wenn der Benutzer Tasten auf der Tastatur drückt. 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

Siehe auch

KEY_DOWN
KEY_UP
KeyLocation


Öffentliche Eigenschaften
 EigenschaftDefiniert von
  altKey : Boolean
Gibt an, ob die Alt-Taste aktiviert (true) oder deaktiviert (false) ist.
KeyboardEvent
 Inheritedbubbles : Boolean
[read-only] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[read-only] 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
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  ctrlKey : Boolean
Gibt an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist.
KeyboardEvent
 InheritedcurrentTarget : Object
[read-only] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
 InheritedeventPhase : uint
[read-only] 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
 Inheritedprototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
Object
  shiftKey : Boolean
Gibt an, ob der Umschalttastenmodifizierer aktiviert (true) oder deaktiviert (false) ist.
KeyboardEvent
 Inheritedtarget : Object
[read-only] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[read-only] Der Typ des Ereignisses.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
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)
Erstellt ein Ereignisobjekt, das bestimmte Informationen über Tastaturereignisse enthält.
KeyboardEvent
  
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, mit der die toString()-Methode in Ihrer benutzerdefinierten Event-Klasse implementiert wird.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob "preventDefault()" im 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
  
Gibt eine Zeichenfolge zurück, die alle Eigenschaften des KeyboardEvent-Objekts enthält.
KeyboardEvent
  
Weist Flash Player nach Abschluss der Verarbeitung dieses Ereignisses zur Wiedergabe an, wenn die Anzeigeliste geändert wurde.
KeyboardEvent
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
 InheritedACTIVATE : String = "activate"
[static] Definiert den Wert der Eigenschaft "type" eines activate-Ereignisobjekts.
Event
 InheritedADDED : String = "added"
[static] Definiert den Wert der Eigenschaft "type" eines added-Ereignisobjekts.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[static] Definiert den Wert der Eigenschaft "type" eines addedToStage-Ereignisobjekts.
Event
 InheritedCANCEL : String = "cancel"
[static] Definiert den Wert der Eigenschaft type eines cancel-Ereignisobjekts.
Event
 InheritedCHANGE : String = "change"
[static] Definiert den Wert der Eigenschaft "type" eines change-Ereignisobjekts.
Event
 InheritedCLOSE : String = "close"
[static] Definiert den Wert der Eigenschaft "type" eines close-Ereignisobjekts.
Event
 InheritedCOMPLETE : String = "complete"
[static] Definiert den Wert der Eigenschaft "type" eines complete-Ereignisobjekts.
Event
 InheritedCONNECT : String = "connect"
[static] Definiert den Wert der Eigenschaft "type" eines connect-Ereignisobjekts.
Event
 InheritedDEACTIVATE : String = "deactivate"
[static] Definiert den Wert der Eigenschaft "type" eines deactivate-Ereignisobjekts.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] Definiert den Wert der Eigenschaft "type" eines enterFrame-Ereignisobjekts.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[static] Definiert den Wert der Eigenschaft "type" eines fullScreen-Ereignisobjekts.
Event
 InheritedID3 : String = "id3"
[static] Definiert den Wert der Eigenschaft "type" eines id3-Ereignisobjekts.
Event
 InheritedINIT : String = "init"
[static] Definiert den Wert der Eigenschaft "type" eines init-Ereignisobjekts.
Event
  KEY_DOWN : String = "keyDown"
[static] Definiert den Wert der Eigenschaft "type" eines keyDown-Ereignisobjekts.
KeyboardEvent
  KEY_UP : String = "keyUp"
[static] Definiert den Wert der Eigenschaft type eines keyUp-Ereignisobjekts.
KeyboardEvent
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] Definiert den Wert der Eigenschaft "type" eines mouseLeave-Ereignisobjekts.
Event
 InheritedOPEN : String = "open"
[static] Definiert den Wert der Eigenschaft "type" eines open-Ereignisobjekts.
Event
 InheritedREMOVED : String = "removed"
[static] Definiert den Wert der Eigenschaft type eines removed-Ereignisobjekts.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[static] Definiert den Wert der Eigenschaft "type" eines removedFromStage-Ereignisobjekts.
Event
 InheritedRENDER : String = "render"
[static] Definiert den Wert der Eigenschaft "type" eines render-Ereignisobjekts.
Event
 InheritedRESIZE : String = "resize"
[static] Definiert den Wert der Eigenschaft type eines resize-Ereignisobjekts.
Event
 InheritedSCROLL : String = "scroll"
[static] Definiert den Wert der Eigenschaft type eines scroll-Ereignisobjekts.
Event
 InheritedSELECT : String = "select"
[static] Definiert den Wert der Eigenschaft type eines select-Ereignisobjekts.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] Definiert den Wert der Eigenschaft "type" eines soundComplete-Ereignisobjekts.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] Definiert den Wert der Eigenschaft "type" eines tabChildrenChange-Ereignisobjekts.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] Definiert den Wert der Eigenschaft type eines tabEnabledChange-Ereignisobjekts.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] Definiert den Wert der Eigenschaft "type" eines tabIndexChange-Ereignisobjekts.
Event
 InheritedUNLOAD : String = "unload"
[static] Definiert den Wert der Eigenschaft "type" eines unload-Ereignisobjekts.
Event
Eigenschaftsdetail
altKeyEigenschaft
altKey:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt an, ob die Alt-Taste aktiviert (true) oder deaktiviert (false) ist. Nur für Windows-Betriebssysteme unterstützt.


Implementierung
    public function get altKey():Boolean
    public function set altKey(value:Boolean):void
charCodeEigenschaft 
charCode:uint  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Enthält den Zeichencodewert der gedrückten bzw. losgelassenen Taste. Die Codewerte sind Werte für die englische Tastatur. Wenn Sie beispielsweise auf einer japanischen Tastatur Umschalt+3 drücken, gibt charCode wie auch bei einer englischen Tastatur das Zeichen # zurück.

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

Siehe auch

ctrlKeyEigenschaft 
ctrlKey:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist.

Hinweis: Der Befehlstasten-Modifizierer auf Macintosh-Systemen muss mithilfe dieses Tastenmodifizierers dargestellt werden.


Implementierung
    public function get ctrlKey():Boolean
    public function set ctrlKey(value:Boolean):void
keyCodeEigenschaft 
keyCode:uint  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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

Siehe auch

keyLocationEigenschaft 
keyLocation:uint  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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
shiftKeyEigenschaft 
shiftKey:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt an, ob der Umschalttastenmodifizierer aktiviert (true) oder deaktiviert (false) ist.


Implementierung
    public function get shiftKey():Boolean
    public function set shiftKey(value:Boolean):void
Konstruktordetail
KeyboardEvent()Konstruktor
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)

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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

Parameter
type:String — Der Ereignistyp. Folgende Werte sind möglich: KeyboardEvent.KEY_DOWN und KeyboardEvent.KEY_UP
 
bubbles:Boolean (default = true) — Legt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt.
 
cancelable:Boolean (default = false) — Legt fest, ob das Ereignisobjekt abgebrochen werden kann.
 
charCode: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 Tastatur Umschalt+3 drücken, gibt getASCIICode() wie auch bei einer englischen Tastatur das Zeichen # zurück.
 
keyCode:uint (default = 0) — Der Tastencodewert der gedrückten bzw. losgelassenen Taste.
 
keyLocation:uint (default = 0) — Die Position der Taste auf der Tastatur.
 
ctrlKey:Boolean (default = false) — Gibt an, ob der Strg-Tasten-Modifizierer aktiviert ist.
 
altKey:Boolean (default = false) — Gibt an, ob der Alt-Tasten-Modifizierer aktiviert ist (nur Windows).
 
shiftKey:Boolean (default = false) — Gibt an, ob der Umschalttasten-Modifizierer aktiviert ist.

Siehe auch

Methodendetail
clone()Methode
public override function clone():Event

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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 
public override function toString():String

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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
Player-Version : Flash Player 9

Weist Flash Player nach Abschluss der Verarbeitung dieses Ereignisses zur Wiedergabe an, wenn die Anzeigeliste geändert wurde.

Konstantendetail
KEY_DOWNKonstante
public static const KEY_DOWN:String = "keyDown"

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Definiert den Wert der Eigenschaft type eines keyDown-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
charCodeDer Zeichencodewert der gedrückten bzw. losgelassenen Taste.
ctrlKeytrue, wenn die Strg-Taste aktiv ist; false, wenn sie nicht aktiv ist.
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.

Siehe auch

KEY_UPKonstante 
public static const KEY_UP:String = "keyUp"

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Definiert den Wert der Eigenschaft type 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.
ctrlKeytrue, wenn die Strg-Taste aktiv ist; false, wenn sie nicht aktiv ist.
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.

Siehe auch

Beispiele Verwendung von Beispielen
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. Es werden Eigenschaften für die spätere Verwendung bei der Festlegung von Farbe und Größe eines Quadrats deklariert.
  2. Die neue Sprite-Instanz child wird erstellt.
  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 zwei Ereignis-Listener vom Typ "keyboard" hinzugefügt:
    • 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.

In einigen Fällen müssen Sie in die Bühne klicken, damit die Tastaturereignisse funktionieren.

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




 

Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/events/KeyboardEvent.html