public interface MouseEvent
MouseEvent
接口提供与鼠标事件相关联的特定上下文信息。
从 UIEvent
继承的 detail
属性指示在用户操作期间同一屏幕位置上鼠标按键被按下和释放的次数。用户开始此操作时属性值为 1,对每个完整的按下和释放序列增加 1。如果用户在 mousedown 和 mouseup 之间移动鼠标,则将值设置为 0,指示没有进行单击操作。
就嵌套元素来说,鼠标事件的目标始终是最里层的嵌套元素。目标元素的祖先可以使用 bubbling 来获得在其后代元素内发生的鼠标事件的通知。
另请参见 Document Object Model (DOM) Level 2 Events Specification。
字段摘要 |
---|
从接口 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 |
方法详细信息 |
---|
int getScreenX()
int getScreenY()
int getClientX()
int getClientY()
boolean getCtrlKey()
boolean getShiftKey()
boolean getAltKey()
boolean getMetaKey()
short getButton()
button
用于指示哪一个鼠标按键改变了状态。
button
值的范围为 0 (指示鼠标的左键)、1(指示中间键(如果有))和 2(指示右键)。对于为左手使用而配置的鼠标,鼠标按键操作正好相反,值改为从右向左读取。
EventTarget getRelatedTarget()
EventTarget
。目前此属性和 mouseover 事件一起使用来指示指点设备退出的
EventTarget
,和 mouseout 事件一起使用指示指点设备进入的
EventTarget
。
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
。