Sys.EventHandlerList 클래스
업데이트: 2007년 11월
이벤트 이름을 키로 지정하고 연결된 처리기를 값으로 지정하여 구성 요소의 클라이언트 이벤트 사전을 만듭니다.
네임스페이스: Sys
상속: 없음
var e = new Sys.EventHandlerList();
생성자
이름 |
설명 |
|---|---|
EventHandlerList 클래스의 새 인스턴스를 초기화합니다. |
멤버
이름 |
설명 |
|---|---|
EventHandlerList 인스턴스에서 지정된 이벤트에 처리기를 연결하고 지정된 이벤트가 목록에 없는 경우 추가합니다. |
|
지정된 이벤트에 대한 모든 처리기를 순차적으로 호출하기 위해 호출할 수 있는 단일 메서드를 반환합니다. |
|
EventHandlerList 인스턴스의 지정된 이벤트에서 이벤트 처리기를 제거합니다. |
설명
EventHandlerList 클래스를 사용하면 사용자 지정 ASP.NET AJAX 구성 요소에서 클라이언트 이벤트를 처리할 수 있습니다. EventHandlerList 클래스는 스크립트 블록, 구성 요소 또는 스크립트 리소스 파일의 이벤트 및 이벤트 처리기를 참조할 수 있는 중앙 위치입니다.
참고
이 클래스는 클라이언트 구성 요소를 개발할 때만 사용되며, 구성 요소 개발 범위를 벗어나는 이벤트 처리 및 DOM 이벤트 바인딩에는 사용되지 않습니다.
이벤트를 발생시키려면 발생시킬 이벤트의 ID를 id 매개 변수에 설정하여 getHandler 메서드를 호출합니다. 그런 다음 getHandler에서 반환되는 메서드를 호출합니다. 이렇게 하면 이벤트의 모든 처리기가 순서대로 호출됩니다.
Sys.Component에서 파생된 클래스의 경우 Sys.Component 기본 클래스의 events 속성을 사용하여 EventHandlerList의 런타임 인스턴스에 액세스할 수 있습니다. 자세한 내용은 Sys.Component.events 속성을 참조하십시오.
예제
다음 예제에서는 사용자 지정 ASP.NET AJAX 컨트롤에서 EventHandlerList 클래스를 사용하는 방법을 보여 줍니다. 사용자 지정 컨트롤을 만드는 방법에 대한 자세한 내용은 사용자 지정 AJAX 클라이언트 컨트롤 만들기를 참조하십시오. 여기에는 이 예제에 사용되는 전체 컨트롤이 포함되어 있습니다.
// Register namespace.
Type.registerNamespace("Demo");
Demo.HoverButton = function(element) {
Demo.HoverButton.initializeBase(this, [element]);
// Create delegates in the Constructor.
this._clickDelegate = null;
}
Demo.HoverButton.prototype = {
// 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);
},
initialize: function() {
var element = this.get_element();
// Bind handler to delegate.
if (this._clickDelegate === null) {
this._clickDelegate = Function.createDelegate(this, this._clickHandler);
}
Sys.UI.DomEvent.addHandler(element, 'click', this._clickDelegate);
Demo.HoverButton.callBaseMethod(this, 'initialize');
},
_clickHandler: function(event) {
var h = this.get_events().getHandler('click');
if (h) h(this, Sys.EventArgs.Empty);
},
// Release resources before control is disposed.
dispose: function() {
var element = this.get_element();
if (this._clickDelegate) {
Sys.UI.DomEvent.removeHandler(element, 'click', this._clickDelegate);
delete this._clickDelegate;
}
Demo.HoverButton.callBaseMethod(this, 'dispose');
}
}
// Register the class.
Demo.HoverButton.registerClass('Demo.HoverButton', Sys.UI.Control);
// Notify the ScriptManager that this is the end of the script.
if (typeof(Sys) !== 'undefined') Sys.Application.notifyScriptLoaded();
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>EventHandlerList Example</title>
</head>
<body>
<form id="form1" runat="server">
<div id="ResultDisplay"></div>
<asp:ScriptManager runat="server" ID="ScriptManager01">
<scripts>
<asp:ScriptReference Path="HoverButton.js" />
</scripts>
</asp:ScriptManager>
<script type="text/javascript">
var app = Sys.Application;
// Add the handler function to the pageLoad event.
app.add_load(applicationLoadHandler);
function applicationLoadHandler(sender, args) {
$create(
Demo.HoverButton,
{element: {style: {borderWidth: "2px"}}},
// Bind the start function to the click event.
{click: start},
null,
$get('Button1')
);
}
function start(sender, args) {
alert("The start function handled the HoverButton click event.");
}
</script>
<button type="button" id="Button1" value="HoverButton">
HoverButton
</button>
</form>
</body>
</html>