getAscii (Key.getAscii メソッド)

public static getAscii() : Number

最後に押されたか離されたキーの ASCII コードを返します。ASCII の戻り値は英語のキーボード値です。たとえば、Shift + 2 が押されると、Key.getAscii() は日本語のキーボードでも英語のキーボードと同じように @ を返します。

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

戻り値

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

例

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

var keyListener:Object = new Object();
keyListener.onKeyDown = function() {
    trace("The ASCII code for the last key typed is: "+Key.getAscii());
};
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 メソッド)

戻り値

例

関連項目