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 キーまたは Control キーがアクティブになっているか（true）非アクティブになっているか（false）を示します。Windows および Linux では、Ctrl キーがアクティブになっているときにも true です。

Windows および Linux では Ctrl キーがアクティブになっているか（true）非アクティブになっているか（false）を示します。Mac OS では Ctrl キーまたは Command キーがアクティブになっているかを示します。

押したキーまたは離したキーのキーコード値です。

注意：IME が実行されているときは、keyCode では正確なキーコードが報告されません。

関連する API エレメント

キーボードのキーの場所を示します。これは、キーボードに複数あるキーを区別するときに役立ちます。例えば、左の Shift キーと右の 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. child という名前の新しい Sprite インスタンスを作成します。
2. 四角形の背景色とサイズの設定に後で使用するプロパティを宣言します。
3. Sprite のメソッドを使用して、addChild() メソッドを呼び出し、明るい青色の四角形を描画してステージ上のデフォルトの座標 (0,0) に表示します。
4. 1 つのマウスイベントリスナーと 2 つのキーボード入力イベントリスナーを追加します。
   • click/clickHandler：四角形をクリックすると送出されます。キーボードイベントをリッスンできるように、child スプライトにフォーカスを設定します。
   • keyDown / keyDownHandler：任意のキーを押したときに送出されます。このサブスクライバメソッドは、trace() ステートメントを使用して、イベントに関する情報を出力します。
   • keyUp/keyUpHandler：キーを離すと送出されます。

この例をテストするときは、最初に四角形をクリックしてキーボードイベントを有効にする必要があります。

また、Flash の「ムービーのテスト」コマンドを使用する場合は、child スプライトに関連付けられたイベントリスナーではなく特定のキーにオーサリングインターフェイスが反応することがあります。

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