Sys.EventHandlerList.removeHandler メソッド
更新 : 2007 年 11 月
EventHandlerList インスタンスのイベントからイベント ハンドラを削除します。
var e = new EventHandlerList();
e.addHandler(id, handler);
e.removeHandler(id, handler);
引数
id
イベントの ID。handler
イベントから削除するハンドラ。
解説
removeHandler メソッドを使用して、EventHandlerList オブジェクトで定義されたイベントからイベント ハンドラを削除します。removeHandler の呼び出し時にイベントにハンドラが 1 つしかない場合、イベントは EventHandlerList インスタンスにプレースホルダとして存在し続けます。
addHandler メソッドと removeHandler メソッドを使用しても、実行時にスクリプト コンポーネントでイベントを動的に変更できます。たとえば、ハンドラを実行時にリストから削除して、最初にイベントが発生したときにのみ実行されるようにすることができます。
使用例
addHandler メソッドおよび removeHandler メソッドをカスタム コントロールで呼び出す方法を次の例に示します。これは EventHandlerList クラスの概要で説明しているコード例の一部です。
// Bind and unbind to click event.
add_click: function(handler) {
this.get_events().addHandler('click', handler);
},
remove_click: function(handler) {
this.get_events().removeHandler('click', handler);
},