模块  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 Level 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()
        用于指示在触发事件期间是否按下'meta'键。 在某些平台上，此密钥可以映射到备用密钥名称。

      • getButton

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

      • getRelatedTarget

        EventTarget getRelatedTarget()
        用于标识与UI事件相关的辅助EventTarget 。 目前，此属性与mouseover事件一起使用以指示指针设备退出的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接口。 只有在通过dispatchEvent方法调度MouseEvent之前，才能调用此方法，但如果需要，可以在该阶段调用多次。 如果多次调用，则最终调用优先。
        参数
        typeArg - 指定事件类型。
        canBubbleArg - 指定事件是否可以冒泡。
        cancelableArg - 指定是否可以阻止事件的默认操作。
        viewArg - 指定 Event的 AbstractView 。
        detailArg - 指定 Event的鼠标单击计数。
        screenXArg - 指定 Event的屏幕x坐标
        screenYArg - 指定 Event的屏幕y坐标
        clientXArg - 指定 Event的客户端x坐标
        clientYArg - 指定 Event的客户端y坐标
        ctrlKeyArg - 指定在 Event期间是否按下了控制键。
        altKeyArg - 指定在 Event期间是否按下了alt键。
        shiftKeyArg - 指定在 Event期间是否按下了shift键。
        metaKeyArg - 指定在 Event期间是否按下了元键。
        buttonArg - 指定 Event的鼠标按钮。
        relatedTargetArg - 指定 Event的相关 EventTarget 。