Sys.UI.DomEvent 类

2008-09-04

更新：2007 年 11 月

提供对与 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 元素移除通过 addHandler 或 addHandlers 方法添加的所有 DOM 事件处理程序。
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>

通过

Sys.UI.DomEvent 类

构造函数

成员

备注

示例

请参见

参考

其他资源

其他资源