Метод Sys.UI.DomEvent addHandler

Предоставляет метод добавления обработчика событий DOM для элемента DOM, предоставляющего событие. Этот элемент является статическим и его можно вызывать, не создавая экземпляр класса.

Sys.UI.DomEvent.addHandler(element, eventName, handler, autoRemove);

Термин

Определение

element

Элемент, предоставляющий событие.

eventName

Имя события.

handler

Клиентская функция, которая вызывается при возникновении события.

autoRemove

(Необязательно.) Логическое значение, определяющее, должен ли обработчик удаляться автоматически после освобождения элемента.

Метод addHandler используется для добавления обработчика событий DOM для элемента, предоставляющего событие. Параметр eventName не должен включать префикс "on". Например, "click" вместо "onclick".

ПримечаниеПримечание

Не используйте метод addHandler для событий ошибок. Сигнатуры событий ошибок отличаются от сигнатур событий DOM, и они не согласованы. События ошибок необходимо связывать вручную.

Доступ к этому методу можно получить с помощью метода $addHandler.

В следующем примере демонстрируется способ связи обработчика событий с элементом с помощью метода addHandler.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<script runat="server">

</script>

<html xmlns="http://www.w3.org/1999/xhtml">

<head id="Head1" runat="server">
    <title>Example</title>
    <style type="text/css">
    #UpdatePanel1 { 
      width:300px; height:100px;
     }
    </style>
</head>
<body>
    <form id="form1" runat="server">
        <asp:ScriptManager ID="ScriptManager1" runat="server"/>
        <asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
            <ContentTemplate>
                <asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
                   <asp:Label ID="Label1" runat="server" Text="Click button to see event details."></asp:Label>
		           <br />
                   <asp:Button ID="Button1" runat="server" Text="Button" AccessKey="b"  />
		           <br />
                   <asp:Label ID="Label2" runat="server"></asp:Label>
                </asp:Panel>
            </ContentTemplate>
        </asp:UpdatePanel>
    </form>
</body>
</html>

<script type="text/javascript">
    Sys.UI.DomEvent.addHandler($get("Button1"), "click", processEventInfo);
    var myArray = ['altKey', 'button', 'charCode', 'clientX', 'clientY',
                   'ctrlKey', 'offsetX', 'offsetY', 'screenX', 'screenY', 
                   'shiftKey', 'target', 'type'];

    function processEventInfo(eventElement) {
        var result = '';
        for (var i = 0, l = myArray.length; i < l; i++) {
            var arrayVal = myArray[i];
            if (typeof(arrayVal) !== 'undefined') {
                // Example: eventElement.clientX
                result += arrayVal + " = " + eval("eventElement." + arrayVal) + '<br/>';
            }
        }
        $get('Label2').innerHTML = result;
    }
 </script>


Показ: