ID: FN1204006 |
Platform: All |
Version: CS6/ActionScript 3.0 |
Runtime: Flash Player 11.3/AIR 3.3 |
このイベントはFlash Player 11.3から備わりました。それより前のバージョンでこのマウス操作を扱う手法については、「マウスイベントMouseEvent.MOUSE_OVERとMouseEvent.ROLL_OVERの違い」の02「イベントのバブリング」をお読みください。
InteractiveObjectクラス |
パッケージ
|
flash.display
|
継承
|
InteractiveObject → DisplayObject → EventDispatcher → Object
|
releaseOutsideイベント |
イベントオブジェクト
|
flash.events.MouseEvent
|
イベント定数
|
MouseEvent.RELEASE_OUTSIDE
|
概要
|
ユーザーがポインティングデバイスの主ボタンをInteractiveObjectインスタンスの上で押し、プレスしたままのボタンをインスタンスの外で放したときに配信される。
|
MouseEventクラス |
パッケージ
|
flash.events
|
継承
|
MouseEvent → Event → Object
|
RELEASE_OUTSIDE定数
|
実装
|
public static const RELEASE_OUTSIDE:String = "releaseOutside"
|
概要
|
"releaseOutside"イベントを定める文字列定数。
|
説明
ユーザーがInteractiveObjectインスタンスの上で押したマウスボタンを、プレスしたままインスタンスの外に出して放したときに配信されるイベントです。Flash Player 11.3からInteractiveObjectクラスに備わりました。
EventDispatcher.addEventListener()やEventDispatcher.removeEventListener()メソッドの第1引数に渡すイベント定数はMouseEvent.RELEASE_OUTSIDEで、値の文字列は"releaseOutside"です。
InteractiveObject.releaseOutsideイベントのリスナー関数は、下表001のようなプロパティが備わったMouseEventオブジェクトを引数に受取ります。
表001■InteractiveObject.releaseOutsideイベントのMouseEventオブジェクトがもつおもなプロパティ
プロパティ |
値 |
クラス |
altKey : Boolean
|
[Alt]/[option]キーが押されていればtrue。押されていなければflase。
|
MouseEvent |
bubbles : Boolean
|
バブリングイベントであることを示すtrue。
|
Event |
buttonDown : Boolean |
マウスの主ボタンが押されていないことを示すfalse。
|
MouseEvent |
cancelable : Boolean |
[読取り専用] イベントに関連づけられたデフォルトの動作が、キャンセルできないことを示すfalse。
|
Event |
ctrlKey : Boolean |
[Ctrl]/[command]キーが押されていればtrue。押されていなければflase。 |
MouseEvent |
currentTarget : Object |
[読取り専用] リスナー関数が加えられて、イベントオブジェクトを現在処理しているインスタンス。 |
Event |
localX : Number |
マウスイベントが起こった水平座標を、親(DisplayObjectContainer)インスタンスから見た数値[*1]。 |
MouseEvent |
localY : Number |
マウスイベントが起こった垂直座標を、親(DisplayObjectContainer)インスタンスから見た数値[*1]。 |
MouseEvent |
shiftKey : Boolean |
[shift]キーが押されていればtrue。押されていなければflase。 |
MouseEvent |
stageX : Number |
[読取り専用] マウスイベントが起こった水平座標を、グローバルなStageオブジェクトから見た数値。 |
MouseEvent |
stageY : Number |
[読取り専用] マウスイベントが起こった垂直座標を、グローバルなStageオブジェクトから見た数値。 |
MouseEvent |
target : Object |
[読取り専用] イベントが起こったターゲットのインスタンス[*2]。 |
Event |
type : String |
[読取り専用] 起こったイベントを示す文字列("releaseOutside")。イベント定数(MouseEvent.RELEASE_OUTSIDE)の値と一致する。 |
Event |
[*1] Stage.mouseLockプロパティにtrueが設定されて、マウスがロックされていると、MouseEvent.localXとMouseEvent.localYプロパティの値は0になります。
[*2] Event.targetプロパティは、イベントが直接生じたターゲットノードのDisplayObjectインスタンスを参照します。そのため、必ずしもイベントリスナーを登録したインスタンスとはかぎりません。Event.currentTargetプロパティを用いると、表示リスト内で現在イベントを処理しているインスタンスが参照できます。
|
参考
[ActionScript 3.0 Reference for the Adobe Flash Platform] > [InteractiveObject]の「releaseOutside Event」の項
[MouseEvent]の「RELEASE_OUTSIDE Constant」の項
作成者: 野中文雄
更新日: 2012年6月9日 Flash Player 11.3正式公開にともない、「参考」のリンクを正規ドキュメントに変更。
作成日: 2012年4月11日