パッケージflash.events
public class KeyboardEvent
継承KeyboardEvent Inheritance Event Inheritance Object

Flash® Player は、キーボードからのユーザー入力に対して KeyboardEvent オブジェクトを送出します。キーボードイベントには、KeyboardEvent.KEY_DOWN と KeyboardEvent.KEY_UP の 2 種類があります。

キーと特定の文字のマッピングはデバイスやオペレーティングシステムごとに異なるため、入力された文字の処理には TextEvent イベントタイプを使用してください。

キーイベントをグローバルにリスニングするには、キャプチャ段階、ターゲット段階またはバブリング段階について Stage でリスニングします。

関連項目

KEY_DOWN
KEY_UP
KeyLocation
キーボードイベントについて
キーボードイベントの処理
keyCode プロパティと charCode プロパティについて
KeyboardEvent の優先度について

パブリックプロパティ
 プロパティ定義
  altKey : Boolean
将来の使用のために予約されています。
KeyboardEvent
 Inheritedbubbles : Boolean
イベントがバブリングイベントかどうかを示します。
Event
 Inheritedcancelable : Boolean
イベントに関連付けられた動作をキャンセルできるかどうかを示します。
Event
  charCode : uint
押したキーまたは離したキーの文字コード値を含みます。
KeyboardEvent
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  ctrlKey : Boolean
Ctrl キーがアクティブ (true) になっているか非アクティブ (false) になっているかを示します。
KeyboardEvent
 InheritedcurrentTarget : Object
イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
Event
 InheritedeventPhase : uint
イベントフローの現在の段階。
Event
  keyCode : uint
押したキーまたは離したキーのキーコード値です。
KeyboardEvent
  keyLocation : uint
キーボードのキーの場所を示します。
KeyboardEvent
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  shiftKey : Boolean
Shift キーモディファイアがアクティブ (true) になっているか非アクティブ (false) になっているかを示します。
KeyboardEvent
 Inheritedtarget : Object
イベントターゲットです。
Event
 Inheritedtype : String
イベントのタイプです。
Event
パブリック Methods
 メソッド定義
  
KeyboardEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, charCode:uint = 0, keyCode:uint = 0, keyLocation:uint = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false)
キーボードイベントに関する特定の情報を含む Event オブジェクトを作成します。
KeyboardEvent
  
clone():Event
KeyboardEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。
KeyboardEvent
 Inherited
formatToString(className:String, ... arguments):String
カスタム Event クラスに toString() メソッドを実装するためのユーティリティ関数です。
Event
 Inherited
hasOwnProperty(name:String):Boolean
指定されたプロパティがオブジェクトに定義されているかどうかを示します。
Object
 Inherited
isDefaultPrevented():Boolean
イベントで preventDefault() が呼び出されたかどうかを確認します。
Event
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
preventDefault():void
イベントのデフォルト動作をキャンセルできる場合に、その動作をキャンセルします。
Event
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
stopImmediatePropagation():void
イベントフローの現在のノードおよび後続するノードで、イベントリスナーが処理されないようにします。
Event
 Inherited
stopPropagation():void
イベントフローの現在のノードに後続するノードで、イベントリスナーが処理されないようにします。
Event
  
toString():String
KeyboardEvent オブジェクトのすべてのプロパティを含むストリングを返します。
KeyboardEvent
  
updateAfterEvent():void
表示リストが変更されている場合は、このイベント終了処理の後にレンダリングするよう Flash Player に指示します。
KeyboardEvent
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
パブリック定数
 定数定義
 InheritedACTIVATE : String = "activate"
[static] activate イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedADDED : String = "added"
[static] added イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[static] addedToStage イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCANCEL : String = "cancel"
[static] cancel イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCHANGE : String = "change"
[static] change イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCLOSE : String = "close"
[static] close イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCOMPLETE : String = "complete"
[static] complete イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCONNECT : String = "connect"
[static] connect イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedDEACTIVATE : String = "deactivate"
[static] deactivate イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] enterFrame イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedFULLSCREEN : String = "fullScreen"
[static] fullScreen イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedID3 : String = "id3"
[static] id3 イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedINIT : String = "init"
[static] init イベントオブジェクトの type プロパティの値を定義します。
Event
  KEY_DOWN : String = "keyDown"
[static] keyDown イベントオブジェクトの type プロパティの値を定義します。
KeyboardEvent
  KEY_UP : String = "keyUp"
[static] keyUp イベントオブジェクトの type プロパティの値を定義します。
KeyboardEvent
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] mouseLeave イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedOPEN : String = "open"
[static] open イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedREMOVED : String = "removed"
[static] removed イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[static] removedFromStage イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedRENDER : String = "render"
[static] render イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedRESIZE : String = "resize"
[static] resize イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedSCROLL : String = "scroll"
[static] scroll イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedSELECT : String = "select"
[static] select イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] soundComplete イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] tabChildrenChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] tabEnabledChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] tabIndexChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedUNLOAD : String = "unload"
[static] unload イベントオブジェクトの type プロパティの値を定義します。
Event
プロパティの詳細
altKeyプロパティ
altKey:Boolean  [read-write]

将来の使用のために予約されています。このプロパティは現在サポートされていません。

実装
    public function get altKey():Boolean
    public function set altKey(value:Boolean):void
charCodeプロパティ 
charCode:uint  [read-write]

押したキーまたは離したキーの文字コード値を含みます。文字コード値は英語キーボードの値です。たとえば、Shift + 3 が押されると、charCode は日本語のキーボードでも英語のキーボードと同じように # を返します。

メモ : 入力メソッドエディタ (IME) の実行中は、charCode では正確な文字コードが報告されません。

実装
    public function get charCode():uint
    public function set charCode(value:uint):void

関連項目

flash.system.IME
ctrlKeyプロパティ 
ctrlKey:Boolean  [read-write]

Ctrl キーがアクティブ (true) になっているか非アクティブ (false) になっているかを示します。

メモ : Macintosh システムの Command キーモディファイアは、このキーモディファイアを使用して表す必要があります。

実装
    public function get ctrlKey():Boolean
    public function set ctrlKey(value:Boolean):void
keyCodeプロパティ 
keyCode:uint  [read-write]

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

メモ : 入力メソッドエディタ (IME) の実行中は、keyCode では正確なキーコードが報告されません。

実装
    public function get keyCode():uint
    public function set keyCode(value:uint):void

関連項目

flash.system.IME
keyLocationプロパティ 
keyLocation:uint  [read-write]

キーボードのキーの場所を示します。これは、キーボードに複数あるキーを区別するときに役立ちます。たとえば、左の Shift キーと右の Shift キーをこのプロパティの値で区別することができます。左は KeyLocation.LEFT、右は KeyLocation.RIGHT です。また、標準キーボードの数字キー (KeyLocation.STANDARD) とテンキーの数字キー (KeyLocation.NUM_PAD) のどちらが押されたかを区別することもできます。

実装
    public function get keyLocation():uint
    public function set keyLocation(value:uint):void
shiftKeyプロパティ 
shiftKey:Boolean  [read-write]

Shift キーモディファイアがアクティブ (true) になっているか非アクティブ (false) になっているかを示します。

実装
    public function get shiftKey():Boolean
    public function set shiftKey(value:Boolean):void
コンストラクタの詳細
KeyboardEvent()コンストラクタ
public 関数 KeyboardEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, charCode:uint = 0, keyCode:uint = 0, keyLocation:uint = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false)

キーボードイベントに関する特定の情報を含む Event オブジェクトを作成します。イベントリスナーには Event オブジェクトがパラメータとして渡されます。

パラメータ
type:String — イベントのタイプです。有効な値は、KeyboardEvent.KEY_DOWN および KeyboardEvent.KEY_UP です。
 
bubbles:Boolean (default = true) — Event オブジェクトがイベントフローのバブリング段階で処理されるかどうかを判断します。
 
cancelable:Boolean (default = false) — Event オブジェクトがキャンセル可能かどうかを判断します。
 
charCode:uint (default = 0) — 押したキーまたは離したキーの文字コード値です。文字コードの戻り値は英語キーボードの値です。たとえば、Shift + 3 が押されると、getASCIICode() メソッドは日本語のキーボードでも英語のキーボードと同じように # を返します。
 
keyCode:uint (default = 0) — 押したキーまたは離したキーのキーコード値です。
 
keyLocation:uint (default = 0) — キーボードのキーの場所です。
 
ctrlKey:Boolean (default = false) — Ctrl キーモディファイアがアクティブになっているかどうかを示します。
 
altKey:Boolean (default = false) — 将来の使用のために予約されています (現在サポートされていません)。
 
shiftKey:Boolean (default = false) — Shift キーモディファイアがアクティブになっているかどうかを示します。

関連項目

KEY_DOWN
KEY_UP
メソッドの詳細
clone()メソッド
public override function clone():Event

KeyboardEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。

戻り値
Event — 元のオブジェクトと同じプロパティ値を含む新しい KeyboardEvent オブジェクトです。
toString()メソッド 
public override function toString():String

KeyboardEvent オブジェクトのすべてのプロパティを含むストリングを返します。ストリングは次の形式です。

[KeyboardEvent type=value bubbles=value cancelable=value ... shiftKey=value]

戻り値
String — KeyboardEvent オブジェクトのすべてのプロパティを含むストリングです。
updateAfterEvent()メソッド 
public function updateAfterEvent():void

表示リストが変更されている場合は、このイベント終了処理の後にレンダリングするよう Flash Player に指示します。

定数の詳細
KEY_DOWN定数
public static const KEY_DOWN:String = "keyDown"

keyDown イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

プロパティ値
bubblestrue
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
charCode押したキーまたは離したキーの文字コード値です。
ctrlKeyCtrl キーがアクティブになっている場合は true、非アクティブになっている場合は false です。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
keyCode押したキーまたは離したキーのキーコード値です。
keyLocationキーボードのキーの場所です。
shiftKeyShift キーがアクティブになっている場合は true、非アクティブになっている場合は false です。
targetフォーカスを持っている InteractiveObject インスタンスです。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。

関連項目

flash.display.InteractiveObject.keyDown
KEY_UP定数 
public static const KEY_UP:String = "keyUp"

keyUp イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

プロパティ値
bubblestrue
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
charCode押したキーまたは離したキーの文字コード値を含みます。
ctrlKeyCtrl キーがアクティブになっている場合は true、非アクティブになっている場合は false です。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
keyCode押したキーまたは離したキーのキーコード値です。
keyLocationキーボードのキーの場所です。
shiftKeyShift キーがアクティブになっている場合は true、非アクティブになっている場合は false です。
targetフォーカスを持っている InteractiveObject インスタンスです。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。

関連項目

flash.display.InteractiveObject.keyUp



© 2004-2007 Adobe Systems Incorporated. All rights reserved.
2007.04.26, 午前 9:17, GMT-07:00