org.w3c.dom.events
接口 MouseEvent

所有超级接口：

Event, UIEvent

public interface MouseEvent
extends UIEvent

MouseEvent 接口提供与鼠标事件相关联的特定上下文信息。

从 UIEvent 继承的 detail 属性指示在用户操作期间同一屏幕位置上鼠标按键被按下和释放的次数。用户开始此操作时属性值为 1，对每个完整的按下和释放序列增加 1。如果用户在 mousedown 和 mouseup 之间移动鼠标，则将值设置为 0，指示没有进行单击操作。

就嵌套元素来说，鼠标事件的目标始终是最里层的嵌套元素。目标元素的祖先可以使用 bubbling 来获得在其后代元素内发生的鼠标事件的通知。

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

从以下版本开始：

DOM Level 2

字段摘要

从接口 org.w3c.dom.events.Event 继承的字段

AT_TARGET, BUBBLING_PHASE, CAPTURING_PHASE

方法摘要

boolean	getAltKey() 用于指示在触发事件期间是否按下 'alt' 键。
short	getButton() 在由按下或释放鼠标的按键引起的鼠标事件期间，button 用于指示哪一个鼠标按键改变了状态。
int	getClientX() 相对于 DOM 实现的客户区域的水平坐标(事件发生在此处)。
int	getClientY() 相对于 DOM 实现的客户区域的垂直坐标(事件发生在此处)。
boolean	getCtrlKey() 用于指示在触发事件事件期间是否按下 'ctrl' 键。
boolean	getMetaKey() 用于指示在触发事件期间是否按下 'meta' 键。
EventTarget	getRelatedTarget() 用于识别与 UI 事件相关的辅助 EventTarget。
int	getScreenX() 相对于屏幕坐标系统原点的水平坐标(事件发生在此处)。
int	getScreenY() 相对于屏幕坐标系统原点的垂直坐标(事件发生在此处)。
boolean	getShiftKey() 用于指示在触发事件期间是否按下 'shift' 键。
void	initMouseEvent(String typeArg, boolean canBubbleArg, boolean cancelableArg, org.w3c.dom.views.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 方法用于初始化通过 DocumentEvent 接口创建的 MouseEvent 的值。

从接口 org.w3c.dom.events.UIEvent 继承的方法

getDetail, getView, initUIEvent

从接口 org.w3c.dom.events.Event 继承的方法

getBubbles, getCancelable, getCurrentTarget, getEventPhase, getTarget, getTimeStamp, getType, initEvent, preventDefault, stopPropagation

方法详细信息

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 值的范围为 0 （指示鼠标的左键）、1（指示中间键（如果有））和 2（指示右键）。对于为左手使用而配置的鼠标，鼠标按键操作正好相反，值改为从右向左读取。

getRelatedTarget

EventTarget getRelatedTarget()

用于识别与 UI 事件相关的辅助 EventTarget。目前此属性和 mouseover 事件一起使用来指示指点设备退出的 EventTarget，和 mouseout 事件一起使用指示指点设备进入的 EventTarget。

initMouseEvent

void initMouseEvent(String typeArg,
                    boolean canBubbleArg,
                    boolean cancelableArg,
                    org.w3c.dom.views.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 方法用于初始化通过 DocumentEvent 接口创建的 MouseEvent 的值。此方法只能在通过 dispatchEvent 方法指派 MouseEvent 之前调用，尽管在该阶段可以多次调用它（如有必要）。如果被多次调用，则最后一次调用优先。

参数：

typeArg - 指定事件类型。

canBubbleArg - 指定该事件是否可以 bubble。

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

viewArg - 指定 Event 的 AbstractView。

detailArg - 指定 Event 的鼠标单击量。

screenXArg - 指定 Event 的屏幕 x 坐标

screenYArg - 指定 Event 的屏幕 y 坐标

clientXArg - 指定 Event 的客户机 x 坐标

clientYArg - 指定 Event 的客户机 y 坐标

ctrlKeyArg - 指定是否在 Event 期间按下 control 键。

altKeyArg - 指定是否在 Event 期间按下 alt 键。

shiftKeyArg - 指定是否在 Event 期间按下 shift 键。

metaKeyArg - 指定是否在 Event 期间按下 meta 键。

buttonArg - 指定 Event 的鼠标按键。

relatedTargetArg - 指定 Event 的相关 EventTarget。