Sys.EventHandlerList.addHandler メソッド
更新 : 2007 年 11 月
ハンドラを EventHandlerList インスタンスの指定したイベントにアタッチします。まだ存在していない場合は、イベントをリストに追加します。
var e = new Sys.EventHandlerList();
e.addHandler(id, handler);
引数
id
イベントを指定する文字列。handler
イベントを処理するメソッド名。
解説
addHandler メソッドは、ハンドラを、プログラムで Microsoft ASP.NET AJAX スクリプト コンポーネントに含まれているイベントにアタッチするために使用します。ASP.NET AJAX コンポーネント イベント モデルでは、クライアント イベントは EventHandlerList オブジェクトに存在します。ハンドラは addHandler メソッドを使用して作成、およびイベントに割り当てられます。その上で、getHandler メソッドによって返されたメソッドを呼び出し、イベントを発生させます。
addHandler に渡した id 値が EventHandlerList インスタンスに既に存在する場合、handler で指定されたメソッドがそのイベントに関連付けられているすべてのハンドラに追加されます。それ以外の場合、指定された ID とハンドラを持つ新しいイベントが EventHandlerList オブジェクトに追加されます。
使用例
カスタム コントロールの 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);
},