org.w3c.dom.events

接口
异常
所有超级接口:
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 - 指定 EventAbstractView
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