getCode (Key.getCode メソッド)

public static getCode() : Number

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

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

Flash アプリケーションが監視できるのは、そのフォーカス内で発生するキーボードイベントのみです。Flash アプリケーションは、別のアプリケーションでのキーボードイベントを検出できません。

対応バージョン : ActionScript 1.0、Flash Player 5

戻り値

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

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

var keyListener:Object = new Object();
keyListener.onKeyDown = function() {
    // compare return value of getCode() to constant
    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 メソッド), isAccessible (Key.isAccessible メソッド)


 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flash/9.0_jp/main/00001759.html