Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Tastatureingabe
tf.border = true;
tf.type = "input";
tf.addEventListener(KeyboardEvent.KEY_DOWN,reportKeyDown);
tf.addEventListener(KeyboardEvent.KEY_UP,reportKeyUp);
function reportKeyDown(event:KeyboardEvent):void
{
trace("Key Pressed: " + String.fromCharCode(event.charCode) + " (key code: " +
event.keyCode + " character code: " + event.charCode + ")");
if (event.keyCode == Keyboard.SHIFT) tf.borderColor = 0xFF0000;
}
function reportKeyUp(event:KeyboardEvent):void
{
trace("Key Released: " + String.fromCharCode(event.charCode) + " (key code: " +
event.keyCode + " character code: " + event.charCode + ")");
if (event.keyCode == Keyboard.SHIFT)
{
tf.borderColor = 0x000000;
}
}
Wenn der Benutzer Text eingibt, meldet die TextField-Klasse auch ein textInput-Ereignis, auf das ebenfalls mit
einem Ereignis-Listener gewartet werden kann. Weitere Informationen finden Sie unter „Erfassen von Texteingaben“
auf Seite 403.
Hinweis: In der AIR-Laufzeit kann ein Tastaturereignis abgebrochen werden. In der Flash Player-Laufzeit kann ein
Tastaturereignis nicht abgebrochen werden.
Tastencodes und Zeichencodes
Flash Player 9 und höher, Adobe AIR 1.0 und höher
Sie können auf die Eigenschaften keyCode und charCode von Tastaturereignissen zugreifen, um die gedrückte Taste
zu ermitteln und dann weitere Aktionen auszulösen. Die keyCode-Eigenschaft ist ein numerischer Wert, der dem
Tastenwert einer Taste auf der Tastatur entspricht. Die charCode-Eigenschaft ist der numerische Wert dieser Taste
im aktuellen Zeichensatz. (Der Standardzeichensatz ist UTF-8, in dem ASCII unterstützt wird.)
Der Hauptunterschied zwischen dem Tastencode und den Zeichenwerten besteht darin, dass ein Tastencodewert
einer bestimmten Taste auf der Tastatur entspricht (die „1“ auf dem numerischen Ziffernblock unterscheidet sich von
der „1“ in der obersten Tastenreihe; die Taste, die „1“ erzeugt, und die Taste, die „!“ erzeugt, ist jedoch dieselbe),
während der Zeichenwert einem bestimmten Zeichen entspricht (die Zeichen „R“ und „r“ sind unterschiedlich).
Hinweis: Einzelheiten zur Zuordnung von Tasten und Zeichencodewerten in ASCII finden Sie in der Beschreibung der
flash.ui.Keyboard-Klasse im ActionScript 3.0-Referenzhandbuch für die Adobe Flash-Plattform.
Die Zuordnung zwischen Tasten und Tastencodes ist abhängig vom Gerät und vom Betriebssystem. Aus diesem
Grund sollten Sie keine Tastenzuordnungen verwenden, um Aktionen auszulösen. Verwenden Sie stattdessen die
vordefinierten Konstantenwerte der Keyboard-Klasse, um auf die entsprechenden keyCode-Eigenschaften zu
verweisen. Verwenden Sie beispielsweise anstelle der Tastenzuordnung für die UMSCHALTTASTE die
entsprechende Konstante Keyboard.SHIFT (wie im vorhergehenden Codebeispiel dargestellt).
Letzte Aktualisierung 27.6.2012
594