Paket | flash.events |
Klasse | public class KeyboardEvent |
Vererbung | KeyboardEvent Event Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Verwandte API-Elemente
Eigenschaft | Definiert 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 | ||
bubbles : Boolean [schreibgeschützt]
Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt. | Event | ||
cancelable : 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 | ||
constructor : 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 | ||
currentTarget : Object [schreibgeschützt]
Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. | Event | ||
eventPhase : 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 | ||
target : Object [schreibgeschützt]
Das Ereignis-Ziel. | Event | ||
type : String [schreibgeschützt]
Der Ereignistyp. | Event |
Methode | Definiert 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 | ||
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen. | Event | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde. | Event | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann. | Event | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | ||
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | ||
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 | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
Konstante | Definiert 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 |
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 |
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.
Parametertype: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
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ückgabewerteEvent — 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 ]
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
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:
Eigenschaft | Wert |
---|---|
bubbles | true |
cancelable | Wert true in AIR, Wert false in Flash Player; in AIR wird durch Abbrechen dieses Ereignisses verhindert, dass das Zeichen in ein Textfeld eingegeben wird. |
charCode | Der Zeichencodewert der gedrückten bzw. losgelassenen Taste. |
commandKey | true unter Mac, wenn die Befehlstaste aktiviert ist. Andernfalls wird false zurückgegeben |
controlKey | true unter Windows und Linux, wenn die Strg-Taste aktiv ist. true unter Mac, wenn die Ctrl-Taste aktiviert ist. Andernfalls wird false zurückgegeben |
ctrlKey | true 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. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
keyCode | Der Tastencodewert der gedrückten bzw. losgelassenen Taste. |
KeyLocation | Die Position der Taste auf der Tastatur. |
shiftKey | true , wenn die Umschalttaste aktiv ist; false , wenn sie nicht aktiv ist. |
target | Die 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:
Eigenschaft | Wert |
---|---|
bubbles | true |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
charCode | Enthält den Zeichencodewert der gedrückten bzw. losgelassenen Taste. |
commandKey | true unter Mac, wenn die Befehlstaste aktiviert ist. Andernfalls wird false zurückgegeben |
controlKey | true unter Windows und Linux, wenn die Strg-Taste aktiv ist. true unter Mac, wenn die Ctrl-Taste aktiviert ist. Andernfalls wird false zurückgegeben |
ctrlKey | true 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. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
keyCode | Der Tastencodewert der gedrückten bzw. losgelassenen Taste. |
KeyLocation | Die Position der Taste auf der Tastatur. |
shiftKey | true , wenn die Umschalttaste aktiv ist; false , wenn sie nicht aktiv ist. |
target | Die 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
Tastaturereignisse und die zugehörigen Listener-Funktionen erläutert. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
- Die neue Sprite-Instanz
child
wird erstellt. - Es werden Eigenschaften für die spätere Verwendung bei der Festlegung von Farbe und Größe eines Quadrats deklariert.
- 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. - 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 daschild
-Sprite zu verlagern, damit es auf Tastaturereignisse warten kann.keyDown
/keyDownHandler
wird bei jedem Tastendruck ausgelöst. Die Abonnentenmethode druckt Informationen zum Ereignis mithilfe dertrace()
-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); } } }
Tue Jun 12 2018, 10:04 AM Z