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 屬性的值相同。

指出 Control 鍵為作用中 (true) 或停用 (false)。在 Windows 和 Linux 中，如果 Ctrl 鍵為作用中，這也是 true。

在 Windows 和 Linux 中，指出 Ctrl 鍵為作用中 (true) 或已停用 (false)；在 Mac OS 中，指出 Ctrl 鍵或 Command 鍵是否為作用中。

按下或放開之按鍵的按鍵碼值。

注意：當您執行輸入法編輯器 (IME) 時，keyCode 將無法報告正確的按鍵碼。

相關 API 元素

指出鍵盤上的按鍵位置。 這有助於區別鍵盤上出現一次以上的按鍵。 例如，您可以根據這個屬性的值來區別左側和右側的 Shift 鍵：KeyLocation.LEFT 代表左側，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. 它會新增一個滑鼠事件和兩個鍵盤類型的事件偵聽程式：
   • 當您按一下正方形以在 child Sprite 上設定焦點時，便會傳送 click/clickHandler，如此它便可以偵聽鍵盤事件。
   • keyDown/keyDownHandler，當按下任何按鍵時傳送。 訂閱者方法會使用 trace() 陳述式來列印與事件相關的資訊。
   • keyUp / keyUpHandler：當放開按鍵時傳送。

測試此範例時，您必須先按一下正方形，鍵盤事件才能運作。

此外，如果您是使用 Flash 中的「測試影片」命令，編寫介面可能會回應特定按鍵，而非附加至該子 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);
        }
        
        
    }
}