MouseEvent
接口提供了与鼠标事件相关的特定上下文信息。
从UIEvent
继承的detail
属性指示鼠标按钮在用户操作期间在同一屏幕位置上被按下和释放的次数。当用户开始此操作时,属性值为1,并且每次完整的按下和释放序列时递增1。如果用户在鼠标按下和鼠标释放之间移动鼠标,则该值将设置为0,表示没有发生点击。
在嵌套元素的情况下,鼠标事件始终针对最深度嵌套的元素。目标元素的祖先元素可以使用冒泡来获取发生在其后代元素内部的鼠标事件的通知。
- 自从:
- 1.5, DOM Level 2
-
Field Summary
Fields declared in interface org.w3c.dom.events.Event
AT_TARGET, BUBBLING_PHASE, CAPTURING_PHASE
-
Method Summary
Modifier and TypeMethodDescriptionboolean
用于指示事件触发时是否按下了'alt'键。short
在由鼠标按钮按下或释放引起的鼠标事件中,button
用于指示哪个鼠标按钮改变了状态。int
事件发生时的水平坐标,相对于DOM实现的客户区域。int
事件发生时的垂直坐标,相对于DOM实现的客户区域。boolean
用于指示事件触发时是否按下了'ctrl'键。boolean
用于指示事件触发时是否按下了'meta'键。用于标识与UI事件相关的次要EventTarget
。int
事件发生时的水平坐标,相对于屏幕坐标系统的原点。int
事件发生时的垂直坐标,相对于屏幕坐标系统的原点。boolean
用于指示事件触发时是否按下了'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
方法用于通过DocumentEvent
接口初始化创建的MouseEvent
的值。Methods declared in interface org.w3c.dom.events.Event
getBubbles, getCancelable, getCurrentTarget, getEventPhase, getTarget, getTimeStamp, getType, initEvent, preventDefault, stopPropagation
Methods declared in interface org.w3c.dom.events.UIEvent
getDetail, getView, initUIEvent
-
Method Details
-
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
方法用于通过DocumentEvent
接口初始化创建的MouseEvent
的值。此方法只能在通过dispatchEvent
方法分派MouseEvent
之前调用,尽管在该阶段可能需要多次调用。如果多次调用,则最后一次调用优先。- 参数:
-
typeArg
- 指定事件类型。 -
canBubbleArg
- 指定事件是否可以冒泡。 -
cancelableArg
- 指定事件的默认操作是否可以被阻止。 -
viewArg
- 指定Event
的AbstractView
。 -
detailArg
- 指定Event
的鼠标点击次数。 -
screenXArg
- 指定Event
的屏幕x坐标。 -
screenYArg
- 指定Event
的屏幕y坐标。 -
clientXArg
- 指定Event
的客户端x坐标。 -
clientYArg
- 指定Event
的客户端y坐标。 -
ctrlKeyArg
- 指定事件期间是否按下了控制键。 -
altKeyArg
- 指定事件期间是否按下了alt键。 -
shiftKeyArg
- 指定事件期间是否按下了shift键。 -
metaKeyArg
- 指定事件期间是否按下了meta键。 -
buttonArg
- 指定Event
的鼠标按钮。 -
relatedTargetArg
- 指定Event
的相关EventTarget
。
-