Module  java.xml
软件包  org.w3c.dom.events

Interface Event

  • All Known Subinterfaces:
    LSLoadEventLSProgressEventMouseEventMutationEventUIEvent


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

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

    从以下版本开始:
    1.5,DOM 2级
    • Field Summary

      Fields  
      Modifier and Type Field 描述
      static short AT_TARGET
      该事件目前正在目标评估 EventTarget
      static short BUBBLING_PHASE
      当前事件阶段是冒泡阶段。
      static short CAPTURING_PHASE
      当前的事件阶段是捕获阶段。
    • 方法摘要

      所有方法  接口方法  抽象方法 
      Modifier and Type 方法 描述
      boolean getBubbles​()
      用于指示事件是否是冒泡事件。
      boolean getCancelable​()
      用于指示事件是否可以防止其默认动作。
      EventTarget getCurrentTarget​()
      用于指示目前正在处理其中的 EventTargetEventListeners
      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
        当前的事件阶段是捕获阶段。
        另请参见:
        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​()
        用于指示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接口。 此方法只能在Event已经通过dispatchEvent方法调度之前调用,尽管如果需要,可能会在该阶段调用多次。 如果多次调用最终调用优先级。 如果从Event接口的子类调用, Event仅修改initEvent方法中指定的值,所有其他属性将保持不变。
        参数
        eventTypeArg - 指定事件类型。 此类型可以是本规范中当前定义的任何事件类型或新的事件类型。该字符串必须是XML名称。 任何新的事件类型不能以字符串“DOM”的任何上,下或混合大小写的形式开头。 该前缀保留用于将来的DOM事件集。 还强烈建议第三方添加自己的事件使用自己的前缀来避免混淆,并减少与其他新事件冲突的可能性。
        canBubbleArg - 指定事件是否可以起泡。
        cancelableArg - 指定是否可以防止事件的默认动作。