JavaTM Platform
Standard Ed. 6

org.w3c.dom.events
接口 Event

所有已知子接口:
LSLoadEvent, LSProgressEvent, MouseEvent, MutationEvent, UIEvent

public interface Event

Event 接口用于为处理事件的处理程序提供关于事件的上下文信息。实现 Event 接口的对象通常作为第一个参数传递给事件处理程序。从 Event(包含与它们附带的事件类型直接相关的信息)派生其他接口,可以将更多特定的上下文信息传递给事件处理程序。这些派生的接口也由传递给事件侦听器的对象实现。

另请参见 Document Object Model (DOM) Level 2 Events Specification

从以下版本开始:
DOM Level 2

字段摘要
static short AT_TARGET
          目前事件正在目标 EventTarget 接受评诂。
static short BUBBLING_PHASE
          当前的事件阶段为 bubbling 阶段。
static short CAPTURING_PHASE
          当前的事件阶段是捕获阶段。
 
方法摘要
 boolean getBubbles()
          用于指示事件是否是 bubbling 事件。
 boolean getCancelable()
          用于指示事件是否可以阻止其默认操作。
 EventTarget getCurrentTarget()
          用于指示当前正在处理其 EventListenersEventTarget
 short getEventPhase()
          用于指示当前正在评诂哪个阶段的事件流。
 EventTarget getTarget()
          用于指示 EventTarget,最初将事件指派给它。
 long getTimeStamp()
          用于指定创建事件的时间(与历元相关,以毫秒为单位)。
 String getType()
          事件的名称(不区分大小写)。
 void initEvent(String eventTypeArg, boolean canBubbleArg, boolean cancelableArg)
          initEvent 方法用于初始化通过 DocumentEvent 接口创建的 Event 的值。
 void preventDefault()
          如果事件可取消,则 preventDefault 方法用于表示要取消该事件,意味着作为事件结果的、通常由该实现采取的任何默认操作将不出现。
 void stopPropagation()
          stopPropagation 方法用于阻止在事件流期间事件的进一步传播。
 

字段详细信息

CAPTURING_PHASE

static final short CAPTURING_PHASE
当前的事件阶段是捕获阶段。

另请参见:
常量字段值

AT_TARGET

static final short AT_TARGET
目前事件正在目标 EventTarget 接受评诂。

另请参见:
常量字段值

BUBBLING_PHASE

static final short BUBBLING_PHASE
当前的事件阶段为 bubbling 阶段。

另请参见:
常量字段值
方法详细信息

getType

String getType()
事件的名称(不区分大小写)。该名称必须是 XML 名称。


getTarget

EventTarget getTarget()
用于指示 EventTarget,最初将事件指派给它。


getCurrentTarget

EventTarget getCurrentTarget()
用于指示当前正在处理其 EventListenersEventTarget。这在捕获和 bubbling 期间特别有用。


getEventPhase

short getEventPhase()
用于指示当前正在评诂哪个阶段的事件流。


getBubbles

boolean getBubbles()
用于指示事件是否是 bubbling 事件。如果事件可以 bubble,则值为 true;否则值为 false。


getCancelable

boolean getCancelable()
用于指示事件是否可以阻止其默认操作。如果可以阻止默认操作,则值为 true;否则值为 false。


getTimeStamp

long getTimeStamp()
用于指定创建事件的时间(与历元相关,以毫秒为单位)。由于有些系统不能提供此信息,timeStamp 的值可能不是对所有事件都可用。当不可用时,将返回值 0。历元时间的示例是系统启动时间,或者 UTC 时间 1970 年 1 月 1 日 0:0:0。


stopPropagation

void stopPropagation()
stopPropagation 方法用于阻止在事件流期间事件的进一步传播。如果任何 EventListener 调用此方法,则该事件将终止沿着树传播。事件流停止之前,该事件将完成向当前 EventTarget 上的所有侦听器的指派。在事件流的任何阶段都可以使用此方法。


preventDefault

void preventDefault()
如果事件可取消,则 preventDefault 方法用于表示要取消该事件,意味着作为事件结果的、通常由该实现采取的任何默认操作将不出现。在事件流的任何阶段,如果调用 preventDefault 方法,则取消该事件。与该事件相关联的任何默认操作都不会发生。对非可取消的事件调用此方法无效。一旦调用 preventDefault,在事件传播的剩余时间内它仍有效。在事件流的任何阶段都可以使用此方法。


initEvent

void initEvent(String eventTypeArg,
               boolean canBubbleArg,
               boolean cancelableArg)
initEvent 方法用于初始化通过 DocumentEvent 接口创建的 Event 的值。此方法只能在通过 dispatchEvent 方法指派 Event 之前调用,尽管在该阶段可以多次调用它(如有必要)。如果被多次调用,则最后一次调用优先。如果从 Event 接口的子类调用,则只修改在 initEvent 方法中指定的值,所有其他属性保持不变。

参数:
eventTypeArg - 指定事件类型。此类型可以是当前在此规范中定义的任何事件类型,或是一个新的事件类型。该字符串必须是 XML 名称。任何新的事件类型一定不能以字符串 "DOM" 的大写、小写或混合大小写版本开头。此前缀是为以后的 DOM 事件集保留的。还强烈推荐添加自己的事件的第三方使用自己的前缀以避免混淆,降低与其他新的事件发生冲突的可能性。
canBubbleArg - 指定该事件是否可以 bubble。
cancelableArg - 指定是否可以阻止事件的默认操作。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策