Platform: All
Version: MX 2004

シンタックス
componentInstance.removeEventListener(イベント名, リスナー)

パラメータ
イベント名  イベントリスナーを削除する対象イベント名をストリングで指定します。

戻り値
なし。

説明
メソッド; UIEventDispatcher.addEventListener()メソッドを使って登録したリスナーオブジェクトまたは関数を、コンポーネントインスタンスのイベントリスナーから削除します。

例
つぎのサンプルは、clickイベントをブロードキャストするコンポーネント(たとえばButton)インスタンスに、イベントリスナーを登録したうえで、そのclickイベントのコールバック関数内でリスナーオブジェクトをイベントリスナーから削除します。したがって、この関数はインスタンスのクリック時に1度だけ呼出され、以降はクリックしても処理が行われません。

listenerObject = new Object();  // リスナーオブジェクトの作成
listenerObject.click = function(eventObject) {  // clickイベントのコールバック関数定義
  trace(eventObject.target); // コンポーネントインスタンスの確認用
  eventObject.target.removeEventListener("click", this);  // イベントリスナーからリスナーオブジェクトを削除
};
componentInstance.addEventListener("click", listenerObject);  // リスナーオブジェクトのイベントリスナーへの登録

Player
Flash Player 6.0r79以降。

関連項目
UIEventDispatcher.addEventListener

_____

作成者: 野中文雄
作成日: 2003年11月26日