stopPropagation()とstopImmediatePropagation()

メソッド名読めます？


イベントの伝播を止める

public function preventDefault():void

イベントに関連付けられたデフォルトの動作をキャンセルする。
但し、Event オブジェクトの cancelable プロパティが true のものだけ有効。

public function isDefaultPrevented():Boolean

既にデフォルトの動作がキャンセルされているかどうか。
戻り値が true なら既に preventDefault() が呼ばれている。

public function stopPropagation():void

そのメソッドを呼び出したイベントリスナーが登録されているオブジェクトでイベントリスナーの呼び出しを終了させる。
※ 現在イベントを処理中のオブジェクトにまだ実行待ちのイベントリスナーが登録されていたら、それは実行する。
※ 有効な対象は自分で追加したリスナーに限定される。
2008/6/20 追記:"自分で追加した"は、ActionScript3のデフォルト以外でという意味。mx.〜系のFlex Framework にて追加されている分は含まれる。みたい。


public function stopImmediatePropagation():void

そのメソッドを呼び出したイベントリスナーが登録されているオブジェクトでイベントリスナーの呼び出しを終了させる。
※ 自身が登録されているオブジェクトを含め、以降のイベントリスナー呼び出しを行わない。
※ 有効な対象は自分で追加したリスナーに限定される。
2008/6/20 追記:"自分で追加した"は、ActionScript3のデフォルト以外でという意味。mx.〜系のFlex Framework にて追加されている分は含まれる。みたい。


上記すべて akihiro kamijoさんのブログの December 09, 2005 の記事から抜粋


さて、問題なのは自分の英語力の無さだったりする。

上記メソッドは、
DataGridなどの複雑にコンポーネントが入り組んだコンポーネントにさらにたくさん手を加える時などによく使っている。

でも

メソッドが読めない。

ペアプロしてても
「ストップなんとかって書いたらええんちゃう？」
で通じ合う(笑)


なので、メソッド名から振る舞いのイメージが全く沸かない。


prevent [ぷりヴぇんと] 妨げる,防ぐ.

preventDefault は デフォルトの（イベントリスナ）を妨げる。

propagate　[ぷらぷぁげぃと] 伝播する.

stopPropagate は 伝播を止める。

immediate　[いみでぃえっと]直接の, すぐ近くの; 即時の; 当面の; 一番近い.

stopImmediatePropagate は 直接の伝播を止める。

ということなんですね。



あーすっきりした。