compact2, compact3

org.w3c.dom.events

Interface Event

All Known Subinterfaces:

LSLoadEvent， LSProgressEvent， MouseEvent， MutationEvent， UIEvent

public interface Event

的 Event接口用来提供一个事件处理程序处理的事件的上下文信息。它实现了 Event接口通常是作为一个事件处理程序的第一个参数传递的对象。更具体的上下文信息汲取其中包含直接相关的事件伴随它们的类型信息 Event附加接口传递到事件处理程序。这些派生的接口也由传递给事件侦听器的对象来实现。

又见Document Object Model (DOM) Level 2 Events Specification。

从以下版本开始：

DOM级别2

Field Summary

Fields

Modifier and Type	Field and Description
static short	AT_TARGET 目前该活动正在向目标 EventTarget评价。
static short	BUBBLING_PHASE 当前事件阶段是起泡阶段。
static short	CAPTURING_PHASE 当前事件阶段是捕获阶段。

方法摘要

Modifier and Type	Method and Description
boolean	getBubbles() 用于表示事件是否是一个起泡事件。
boolean	getCancelable() 用来表示一个事件是否可以防止它的默认操作。
EventTarget	getCurrentTarget() 用于指示其 EventListeners目前正在处理的 EventTarget。
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方法用于防止在事件流事件的进一步传播。

Field Detail

CAPTURING_PHASE

static final short CAPTURING_PHASE

当前事件阶段是捕获阶段。

另请参见：

Constant Field Values

AT_TARGET

static final short AT_TARGET

目前该活动正在向目标 EventTarget评价。

另请参见：

Constant Field Values

BUBBLING_PHASE

static final short BUBBLING_PHASE

当前事件阶段是起泡阶段。

另请参见：

Constant Field Values

方法详细信息

getType

String getType()

事件的名称（不区分大小写）。名称必须是一个XML名称。

getTarget

EventTarget getTarget()

用于指示 EventTarget，事件最初出动。

getCurrentTarget

EventTarget getCurrentTarget()

用于指示其 EventListeners目前正在处理的 EventTarget。这是特别有用的，在捕获和鼓泡。

getEventPhase

short getEventPhase()

用于表示当前正在评估的事件流的哪个阶段。

getBubbles

boolean getBubbles()

用于表示事件是否是一个起泡事件。如果事件可以泡的值是真的，否则值是假的。

getCancelable

boolean getCancelable()

用来表示一个事件是否可以防止它的默认操作。如果默认操作可以防止值为真，则该值为假。

getTimeStamp

long getTimeStamp()

用于指定要创建事件的时间（以毫秒为单位的时间）。由于有些系统可能不提供此信息的 timeStamp的价值可能不适用于所有的事件。当不可用时，将返回0的值。时代的例子是系统启动或0:0:0 UTC时间1970年1月1日。

stopPropagation

void stopPropagation()

的 stopPropagation方法用于防止在事件流事件的进一步传播。如果这种方法被任何 EventListener事件将不再通过树传播。该活动将完成调度所有的听众对当前 EventTarget在事件流停止。此方法可在事件流的任何阶段使用。

preventDefault

void preventDefault()

如果一个事件是可撤销的 preventDefault方法用于表示事件被取消，这意味着任何违约行为通常被实现为结果的事件将不会发生。如果在事件流的任何阶段，这 preventDefault方法叫做活动取消。任何与事件关联的默认操作不会发生。调用此方法的一个不可取消的事件没有影响。一旦 preventDefault一直称它将继续影响整个事件传播的余数。此方法可在事件流的任何阶段使用。

initEvent

void initEvent(String eventTypeArg,
               boolean canBubbleArg,
               boolean cancelableArg)

的 initEvent方法是用来初始化通过 DocumentEvent接口创建了一个 Event价值。此方法只可在 Event已派出通过 dispatchEvent方法，尽管它可能被多次调用，在这个阶段，如果有必要的话。如果调用多次，最终调用优先。如果从一种叫做子类 Event接口只有在 initEvent法规定进行修改，其它属性不变。

参数

eventTypeArg -指定事件类型。此类型可能是在本规范中定义的任何事件类型或一个新的事件类型。字符串必须是一个XML名称。任何新的事件类型不能从任何的上，下，或混合版本的字符串“DOM”。这个前缀是预留给未来的DOM事件集。还强烈建议，第三方加入自己的事件使用自己的前缀，以避免混乱，并减少与其他新事件的冲突的概率。

canBubbleArg -指定事件是否能泡。

cancelableArg -指定是否可以阻止事件的默认行为。