Класс Sys.UI.DomEvent

Предоставляет не зависящий от веб-обозревателя доступ к полям и методам, связанным с обработчиками событий элементов DOM.

Пространство имен: Sys.UI

Наследования: отсутствуют

var domEvent = Sys.UI.DomEvent(domObject);

Конструкторы

Имя

Описание

Конструктор Sys.UI.DomEvent

Инициализирует новый экземпляр класса DomEvent.

Члены

Имя

Описание

Метод Sys.UI.DomEvent addHandler

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

Метод Sys.UI.DomEvent addHandlers

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

Метод Sys.UI.DomEvent clearHandlers

Удаляет все обработчики событий DOM из элемента DOM, которые были добавлены методом addHandler или addHandlers.

Метод Sys.UI.DomEvent preventDefault

Предотвращает выполнение действия события DOM по умолчанию.

Метод Sys.EventHandlerList.removeHandler

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

Метод Sys.UI.DomEvent stopPropagation

Предотвращает распространение события к родительским элементам.

Поле Sys.UI.DomEvent altKey

Возвращает значение, указывающее состояние клавиши ALT при возникновении связанного события.

Поле Sys.UI.DomEvent button

Возвращает значение перечисления Sys.UI.MouseButton , указывающее состояние кнопки мыши при возникновении связанного события.

Поле Sys.UI.DomEvent charCode

Возвращает код символа клавиши, нажатие которой вызвало соответствующее событие.

Поле Sys.UI.DomEvent clientX

Получает координату указателя мыши по оси X относительно клиентской области окна обозревателя, за исключением полос прокрутки окна.

Поле Sys.UI.DomEvent clientY

Получает координату указателя мыши по оси Y относительно клиентской области окна обозревателя, за исключением полос прокрутки окна.

Поле Sys.UI.DomEvent ctrlKey

Возвращает значение, указывающее состояние клавиши CTRL при возникновении связанного события.

Поле Sys.UI.DomEvent charCode

Возвращает код клавиши, вызвавшей событие keyUp или keyDown.

Поле Sys.UI.DomEvent offsetX

Возвращает координату указателя мыши по оси X относительно объекта, инициировавшего событие.

Поле Sys.UI.DomEvent offsetY

Возвращает координату указателя мыши по оси Y относительно объекта, инициировавшего событие.

Поле Sys.UI.DomEvent screenX

Получает координату указателя мыши по оси X относительно экрана пользователя.

Поле Sys.UI.DomEvent screenY

Получает координату указателя мыши по оси Y относительно экрана пользователя.

Поле Sys.UI.DomEvent shiftKey

Возвращает значение, указывающее состояние клавиши SHIFT при возникновении связанного события.

Поле Sys.UI.DomEvent target

Возвращает объект, в котором действует событие.

Поле Sys.UI.DomEvent type

Возвращает имя возникшего события.

Заметки

Класс DomEvent используется для добавления, удаления, изменения и обработки клиентских событий. Этот класс также можно использовать для извлечения свойств, связанных с событием.

Пример

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

<%@ Page Language="VB" %>

<!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>
<%@ 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>

См. также

Ссылки

Оператор new

Другие ресурсы

Справочник по языку