模块  java.xml
软件包  org.w3c.dom.events

Interface Event

  • All Known Subinterfaces:
    LSLoadEvent , LSProgressEvent , MouseEvent , MutationEvent , UIEvent

    public interface Event
    Event接口用于向处理事件的处理程序提供有关事件的上下文信息。 实现Event接口的对象通常作为第一个参数传递给事件处理程序。 通过从Event获得包含与其伴随的事件类型直接相关的信息的附加接口, Event具体的上下文信息传递给事件处理程序。 这些派生接口也由传递给事件侦听器的对象实现。

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

    从以下版本开始:
    1.5,DOM Level 2
    • 字段汇总

      字段  
      变量和类型 字段 描述
      static short AT_TARGET
      该事件目前正在目标 EventTarget进行评估。
      static short BUBBLING_PHASE
      当前事件阶段是冒泡阶段。
      static short CAPTURING_PHASE
      当前事件阶段是捕获阶段。
    • 方法摘要

      所有方法  实例方法 抽象方法 
      变量和类型 方法 描述
      boolean getBubbles()
      用于指示事件是否为冒泡事件。
      boolean getCancelable()
      用于指示事件是否可以阻止其默认操作。
      EventTarget getCurrentTarget()
      用于指示 EventTarget其 EventListeners ,目前正在处理。
      short getEventPhase()
      用于指示当前正在评估事件流的哪个阶段。
      EventTarget getTarget()
      用于指示最初调度事件的 EventTarget 。
      long getTimeStamp()
      用于指定创建事件的时间(相对于纪元的毫秒数)。
      String getType()
      事件的名称(不区分大小写)。
      void initEvent​(String eventTypeArg, boolean canBubbleArg, boolean cancelableArg)
      该 initEvent方法用于初始化的值 Event通过创建 DocumentEvent接口。
      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
        当前事件阶段是冒泡阶段。
        另请参见:
        常数字段值
    • 方法详细信息

      • getType

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

        EventTarget getTarget()
        用于指示事件最初分派到的 EventTarget 。
      • getCurrentTarget

        EventTarget getCurrentTarget()
        用于指示EventTarget其EventListeners ,目前正在处理。 这在捕获和冒泡期间特别有用。
      • getEventPhase

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

        boolean getBubbles()
        用于指示事件是否为冒泡事件。 如果事件可以冒泡,则值为true,否则值为false。
      • getCancelable

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

        long getTimeStamp()
        用于指定创建事件的时间(相对于纪元的毫秒数)。 由于某些系统可能无法提供此信息,因此timeStamp的值可能不适用于所有事件。 如果不可用,将返回值0。 纪元时间的示例是系统启动的时间或1970年1月1日0:0:0 UTC。
      • stopPropagation

        void stopPropagation()
        使用stopPropagation方法防止在事件流期间进一步传播事件。 如果任何EventListener调用此方法,则事件将停止在树中传播。 在事件流程停止之前,该事件将完成对当前EventTarget上所有侦听器的调度。 可以在事件流的任何阶段使用该方法。
      • preventDefault

        void preventDefault()
        如果事件可取消,则使用preventDefault方法表示要取消事件,这意味着不会发生由于事件而通常由实现采取的任何默认操作。 如果在事件流的任何阶段,调用preventDefault方法,则取消事件。 不会发生与该事件关联的任何默认操作。 将此方法调用为不可取消的事件无效。 一旦preventDefault ,它将在整个事件的传播过程中保持有效。 可以在事件流的任何阶段使用该方法。
      • initEvent

        void initEvent​(String eventTypeArg,
                       boolean canBubbleArg,
                       boolean cancelableArg)
        该initEvent方法用于初始化的值Event通过创建DocumentEvent接口。 只有在通过dispatchEvent方法调度Event之前,才能调用此方法,但如果需要,可以在该阶段调用多次。 如果多次调用,则最终调用优先。 如果从Event接口的子类调用, Event仅修改initEvent方法中指定的值,所有其他属性保持不变。
        参数
        eventTypeArg - 指定事件类型。 此类型可以是当前在此规范中定义的任何事件类型或新的事件类型。该字符串必须是XML名称。 任何新的事件类型都不能以字符串“DOM”的任何大写,小写或混合大小写形式开头。 此前缀保留给将来的DOM事件集。 强烈建议第三方添加自己的事件使用自己的前缀以避免混淆并减少与其他新事件冲突的可能性。
        canBubbleArg - 指定事件是否可以冒泡。
        cancelableArg - 指定是否可以阻止事件的默认操作。