KeyboardEvent  - AS3

在 Windows 中，表示 Alt 键是处于活动状态 (true) 还是非活动状态 (false)；在 Mac OS 中，表示 Option 键是否处于活动状态。

包含按下或释放的键的字符代码值。字符代码值为英文键盘值。例如，如果您按 Shift+3，则 charCode 会在日文键盘上返回 #；如果您按 Shift+2，则 charCode 德国键盘上的 @（而不是 "），就像在英文键盘上一样。

注意：当输入法编辑器 (IME) 正在运行时，charCode 不会报告精确的字符代码。

表示 Command 键是处于活动状态 (true) 还是非活动状态 (false)。仅 Mac OS 支持。在 Mac OS 中，commandKey 属性具有与 ctrlKey 属性相同的值。

表示 Ctrl 键是处于活动状态 (true) 还是非活动状态 (false)。在 Windows 和 Linux 中，Ctrl 键处于活动状态时这也为 true。

在 Windows 和 Linux 中，表示 Ctrl 键是处于活动状态 (true) 还是非活动状态 (false)；在 Mac OS 中，表示 Ctrl 键或 Command 键是否处于活动状态。

按下或释放的键的键控代码值。

注意：当输入法编辑器 (IME) 正在运行时，keyCode 不会报告精确的键控代码。

相关 API 元素

表示键在键盘上的位置。这对于区分在键盘上多次出现的键非常有用。例如，您可以根据此属性的值来区分左 Shift 键和右 Shift 键：左 Shift 键的值为 KeyLocation.LEFT，右 Shift 键的值为 KeyLocation.RIGHT。另一个示例是区分标准键盘 (KeyLocation.STANDARD) 与数字键盘 (KeyLocation.NUM_PAD) 上按下的数字键。

表示 Shift 功能键是处于活动状态 (true) 还是非活动状态 (false)。

创建一个 Event 对象，其中包含有关键盘事件的特定信息。将 Event 对象作为参数传递给事件侦听器。

相关 API 元素

创建 KeyboardEvent 对象的副本，并设置每个属性的值以匹配原始属性值。

返回一个字符串，其中包含 KeyboardEvent 对象的所有属性。字符串的格式如下：

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

表示如果已修改显示列表，则应该在此事件处理完成后呈示显示结果

KeyboardEvent.KEY_DOWN 常量定义 keyDown 事件对象的 type 属性的值。

此事件具有以下属性：

相关 API 元素

KeyboardEvent.KEY_UP 常量定义 keyUp 事件对象的 type 属性值。

此事件具有以下属性：

相关 API 元素

1. 它创建一个新的 Sprite 实例，名称为 child。
2. 它声明了以后在设置正方形的背景颜色和大小时使用的属性。
3. 使用 Sprite 的方法，它通过调用 addChild() 方法绘制一个浅蓝色正方形，其显示在舞台上的默认坐标 (0,0) 处。
4. 它添加了一个鼠标事件两个键盘类型事件侦听器：
   • click/clickHandler，在单击正方形将焦点设置在 child sprite 上以使它可以侦听键盘事件时进行调度。
   • keyDown/keyDownHandler，按下任何键时将调度这两个侦听器。订阅者方法使用 trace() 语句输出有关事件的信息。
   • keyUp / keyUpHandler，在释放某个键时进行调度。

在测试此示例时，需要首先单击此正方形才能让键盘事件正常工作。

此外，如果使用 Flash 中的“测试影片”命令，创作界面可能会响应特定的键，而不会响应附加该 child sprite 的事件侦听器。

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