getCode (Key.getCode メソッド)

public static getCode() : Number

最後に押されたキーのキーコード値を返します。

メモ : このメソッドの Flash Lite 版は、プラットフォームによって渡されるキーコードに応じて、ストリングまたは数字を返します。有効なキーコードは、このクラスが受け付ける標準キーコードと ExtendedKey クラスのプロパティとしてリストアップされている特殊キーのコードだけです。

使用できるバージョン : ActionScript 1.0、Flash Lite 2.0

戻り値

Number - 最後に押されたキーのキーコード。このメソッドは、押されたり、離されたりしたキーがなかった場合、またはセキュリティ上の理由でキーコードにアクセスできない場合は、0 を返します。

次の例では、キーが押されるたびに getCode() メソッドを呼び出します。リスナーオブジェクト keyListener を作成し、onKeyDown イベントの発生時に Key.getCode() を呼び出す関数を定義します。次に、keyListener オブジェクトを Key オブジェクトに登録します。Key は、SWF ファイルの再生中にキーが押されるたびに onKeyDown メッセージをブロードキャストします。

var keyListener: Object = new Object();
keyListener.onKeyDown = function() {
    // getCode() の戻り値と定数を比較する
    if (Key.getCode() == Key.ENTER) {
        trace ("Virtual key code: "+Key.getCode()+" (ENTER key)");
    } 
    else {
        trace("Virtual key code: "+Key.getCode());
    }
};
Key.addListener(keyListener);

この例を使用する場合、テスト環境では [制御]-[キーボードショートカットを無効] を選択してください。

次の例では、Key.getAscii() の呼び出しを追加して、2 つのメソッドの相違点を示します。最も大きな違いは、Key.getAscii() では大文字と小文字が区別されるのに対し、Key.getCode() では大文字と小文字が区別されないことです。

var keyListener: Object = new Object();
keyListener.onKeyDown = function() {
    trace("For the last key typed: ");
    trace("\tThe Key code is: "+Key.getCode());
    trace("\tThe ASCII value is: "+Key.getAscii());
    trace("");
};
Key.addListener(keyListener);

この例を使用する場合、テスト環境では [制御]-[キーボードショートカットを無効] を選択してください。

関連項目

getAscii (Key.getAscii メソッド)