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

Interface MouseEvent

  • All Superinterfaces:
    Event ， UIEvent 

    public interface MouseEvent
extends UIEvent
    MouseEvent界面提供与鼠标事件相关联的特定上下文信息。

    从UIEvent继承的detail属性表示在用户操作期间通过同一屏幕位置按下并释放鼠标按钮的次数。 当用户开始此操作时，属性值为1，并且对于每个完整的按压和释放序列递增1。 如果用户在mousedown和mouseup之间移动鼠标，则该值将被设置为0，表示没有发生任何点击。

    在嵌套元素的情况下，鼠标事件总是针对最深入的嵌套元素。 目标元素的祖先可以使用冒泡来获得在其后代元素内发生的鼠标事件的通知。

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

    从以下版本开始：
    1.5，DOM 2级

    • 方法详细信息

      • getScreenX

        int getScreenX​()
        事件发生的水平坐标相对于屏幕坐标系的原点。

      • getScreenY

        int getScreenY​()
        事件发生的垂直坐标相对于屏幕坐标系的原点。

      • getClientX

        int getClientX​()
        事件相对于DOM实现的客户区域发生的水平坐标。

      • getClientY

        int getClientY​()
        事件发生的垂直坐标相对于DOM实现的客户区。

      • getCtrlKey

        boolean getCtrlKey​()
        用于指示在触发事件期间是否按下“ctrl”键。

      • getShiftKey

        boolean getShiftKey​()
        用于指示在触发事件期间“shift”键是否被压制。

      • getAltKey

        boolean getAltKey​()
        用于指示在事件触发期间“alt”键是否被按下。 在某些平台上，此密钥可能映射到另一个密钥名称。

      • getMetaKey

        boolean getMetaKey​()
        用于指示在触发事件期间“元”键是否被压制。 在某些平台上，此密钥可能映射到另一个密钥名称。

      • getButton

        short getButton​()
        在由鼠标按键或鼠标按键释放引起的鼠标事件期间，使用button指示哪个鼠标按钮改变状态。 button的值范围为零，表示鼠标的左侧按钮，一个用于指示中间按钮（如果存在），另外两个表示右侧按钮。 对于配置为左手使用的鼠标，其中按钮动作被反转，而是从右到左读取值。

      • getRelatedTarget

        EventTarget getRelatedTarget​()
        用于识别与UI事件相关的辅助EventTarget 。 目前，该属性与鼠标悬停事件一起使用以指示指示设备退出的EventTarget ，并且mouseout事件指示指向设备输入的EventTarget 。

      • initMouseEvent

        void initMouseEvent​(String typeArg,
                    boolean canBubbleArg,
                    boolean cancelableArg,
                    AbstractView viewArg,
                    int detailArg,
                    int screenXArg,
                    int screenYArg,
                    int clientXArg,
                    int clientYArg,
                    boolean ctrlKeyArg,
                    boolean altKeyArg,
                    boolean shiftKeyArg,
                    boolean metaKeyArg,
                    short buttonArg,
                    EventTarget relatedTargetArg)
        initMouseEvent方法用于初始化通过MouseEvent创建的DocumentEvent接口的值。 在MouseEvent已经通过dispatchEvent方法调度之前，此方法只能被调用，尽管如果需要，可能会在该阶段调用多次。 如果多次调用，则最终调用优先。
        参数
        typeArg - 指定事件类型。
        canBubbleArg - 指定事件是否可以起泡。
        cancelableArg - 指定是否可以防止事件的默认动作。
        viewArg - 指定 Event的 AbstractView 。
        detailArg - 指定 Event的鼠标点击次数。
        screenXArg - 指定 Event的屏幕x坐标
        screenYArg - 指定 Event的屏幕y坐标
        clientXArg - 指定 Event的客户端x坐标
        clientYArg - 指定 Event的客户端y坐标
        ctrlKeyArg - 指定 Event期间控制键是否被按下。
        altKeyArg - 指定在 Event期间是否 altKeyArg Alt键。
        shiftKeyArg - 指定在 Event期间是否按下Shift键。
        metaKeyArg - 指定在 Event期间是否抑制了元键。
        buttonArg - 指定 Event的鼠标按钮。
        relatedTargetArg - 指定 Event的相关 EventTarget 。