-
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级
-
-
Field Summary
-
Fields inherited from interface org.w3c.dom.events.Event
AT_TARGET, BUBBLING_PHASE, CAPTURING_PHASE
-
-
方法摘要
所有方法 接口方法 抽象方法 Modifier and Type 方法 描述 boolean
getAltKey()
用于指示在事件触发期间“alt”键是否被按下。short
getButton()
在鼠标按键或鼠标按键释放引起的鼠标事件期间,button
用于指示哪个鼠标按钮改变状态。int
getClientX()
事件相对于DOM实现的客户区域发生的水平坐标。int
getClientY()
事件发生的垂直坐标相对于DOM实现的客户区。boolean
getCtrlKey()
用于指示在触发事件期间是否按下“ctrl”键。boolean
getMetaKey()
用于指示在触发事件期间“元”键是否被压制。EventTarget
getRelatedTarget()
用于识别与UI事件相关的辅助EventTarget
。int
getScreenX()
事件发生的水平坐标相对于屏幕坐标系的原点。int
getScreenY()
事件发生的垂直坐标相对于屏幕坐标系的原点。boolean
getShiftKey()
用于指示在触发事件期间“shift”键是否被压制。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
接口。-
Methods inherited from interface org.w3c.dom.events.Event
getBubbles, getCancelable, getCurrentTarget, getEventPhase, getTarget, getTimeStamp, getType, initEvent, preventDefault, stopPropagation
-
Methods inherited from interface org.w3c.dom.events.UIEvent
getDetail, getView, initUIEvent
-
-
-
-
方法详细信息
-
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
。
-
-