org.w3c.dom.events
Interface MouseEvent

All Superinterfaces:
Event, UIEvent
All Known Implementing Classes:
DOMMouseEvent

public interface MouseEvent
extends UIEvent

The MouseEvent interface provides specific contextual information associated with Mouse events.

In the case of nested elements mouse events are always targeted at the most deeply nested element. Ancestors of the targeted element may use bubbling to obtain notification of mouse events which occur within theirs descendent elements.

To create an instance of the MouseEvent interface, use the DocumentEvent.createEvent("MouseEvent") method call.

Note: When initializing MouseEvent objects using initMouseEvent or initMouseEventNS, implementations should use the client coordinates clientX and clientY for calculation of other coordinates (such as target coordinates exposed by DOM Level 0 implementations).

See also the Document Object Model (DOM) Level 3 Events Specification .

Since:
DOM Level 2

Field Summary
 
Fields inherited from interface org.w3c.dom.events.Event
AT_TARGET, BUBBLING_PHASE, CAPTURING_PHASE
 
Method Summary
 boolean getAltKey()
          true if the alt (alternative) key modifier is activated.
 short getButton()
          During mouse events caused by the depression or release of a mouse button, button is used to indicate which mouse button changed state.
 int getClientX()
          The horizontal coordinate at which the event occurred relative to the DOM implementation's client area.
 int getClientY()
          The vertical coordinate at which the event occurred relative to the DOM implementation's client area.
 boolean getCtrlKey()
          true if the control (Ctrl) key modifier is activated.
 boolean getMetaKey()
          true if the meta (Meta) key modifier is activated.
 boolean getModifierState(String keyIdentifierArg)
          This methods queries the state of a modifier using a key identifier.
 EventTarget getRelatedTarget()
          Used to identify a secondary EventTarget related to a UI event, depending on the type of event.
 int getScreenX()
          The horizontal coordinate at which the event occurred relative to the origin of the screen coordinate system.
 int getScreenY()
          The vertical coordinate at which the event occurred relative to the origin of the screen coordinate system.
 boolean getShiftKey()
          true if the shift (Shift) key modifier is activated.
 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)
          The initMouseEvent method is used to initialize the value of a MouseEvent object and has the same behavior as UIEvent.initUIEvent().
 void initMouseEventNS(String namespaceURI, String typeArg, boolean canBubbleArg, boolean cancelableArg, AbstractView viewArg, int detailArg, int screenXArg, int screenYArg, int clientXArg, int clientYArg, short buttonArg, EventTarget relatedTargetArg, String modifiersList)
          The initMouseEventNS method is used to initialize the value of a MouseEvent object and has the same behavior as UIEvent.initUIEventNS().
 
Methods inherited from interface org.w3c.dom.events.UIEvent
getDetail, getView, initUIEvent, initUIEventNS
 
Methods inherited from interface org.w3c.dom.events.Event
getBubbles, getCancelable, getCurrentTarget, getDefaultPrevented, getEventPhase, getNamespaceURI, getTarget, getTimeStamp, getType, initEvent, initEventNS, preventDefault, stopImmediatePropagation, stopPropagation
 

Method Detail

getScreenX

public int getScreenX()
The horizontal coordinate at which the event occurred relative to the origin of the screen coordinate system.


getScreenY

public int getScreenY()
The vertical coordinate at which the event occurred relative to the origin of the screen coordinate system.


getClientX

public int getClientX()
The horizontal coordinate at which the event occurred relative to the DOM implementation's client area.


getClientY

public int getClientY()
The vertical coordinate at which the event occurred relative to the DOM implementation's client area.


getCtrlKey

public boolean getCtrlKey()
true if the control (Ctrl) key modifier is activated.


getShiftKey

public boolean getShiftKey()
true if the shift (Shift) key modifier is activated.


getAltKey

public boolean getAltKey()
true if the alt (alternative) key modifier is activated.

Note: The Option key modifier on Macintosh systems must be represented using this key modifier.


getMetaKey

public boolean getMetaKey()
true if the meta (Meta) key modifier is activated.

Note: The Command key modifier on Macintosh system must be represented using this meta key.


getButton

public short getButton()
During mouse events caused by the depression or release of a mouse button, button is used to indicate which mouse button changed state. 0 indicates the normal button of the mouse (in general on the left or the one button on Macintosh mice, used to activate a button or select text). 2 indicates the contextual property (in general on the right, used to display a context menu) button of the mouse if present. 1 indicates the extra (in general in the middle and often combined with the mouse wheel) button. Some mice may provide or simulate more buttons, and values higher than 2 can be used to represent such buttons.


getRelatedTarget

public EventTarget getRelatedTarget()
Used to identify a secondary EventTarget related to a UI event, depending on the type of event.


initMouseEvent

public 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)
The initMouseEvent method is used to initialize the value of a MouseEvent object and has the same behavior as UIEvent.initUIEvent().

Parameters:
typeArg - Refer to the UIEvent.initUIEvent() method for a description of this parameter.
canBubbleArg - Refer to the UIEvent.initUIEvent() method for a description of this parameter.
cancelableArg - Refer to the UIEvent.initUIEvent() method for a description of this parameter.
viewArg - Refer to the UIEvent.initUIEvent() method for a description of this parameter.
detailArg - Refer to the UIEvent.initUIEvent() method for a description of this parameter.
screenXArg - Specifies MouseEvent.screenX.
screenYArg - Specifies MouseEvent.screenY.
clientXArg - Specifies MouseEvent.clientX.
clientYArg - Specifies MouseEvent.clientY.
ctrlKeyArg - Specifies MouseEvent.ctrlKey.
altKeyArg - Specifies MouseEvent.altKey.
shiftKeyArg - Specifies MouseEvent.shiftKey.
metaKeyArg - Specifies MouseEvent.metaKey.
buttonArg - Specifies MouseEvent.button.
relatedTargetArg - Specifies MouseEvent.relatedTarget. This value may be null.

getModifierState

public boolean getModifierState(String keyIdentifierArg)
This methods queries the state of a modifier using a key identifier. See also .

Parameters:
keyIdentifierArg - A modifier key identifier, as defined by the KeyboardEvent.keyIdentifier attribute. Common modifier keys are "Alt", "AltGraph", "CapsLock", "Control", "Meta" , "NumLock", "Scroll", or "Shift".

Note: If an application wishes to distinguish between right and left modifiers, this information could be deduced using keyboard events and KeyboardEvent.keyLocation.

Returns:
true if it is modifier key and the modifier is activated, false otherwise.
Since:
DOM Level 3

initMouseEventNS

public void initMouseEventNS(String namespaceURI,
                             String typeArg,
                             boolean canBubbleArg,
                             boolean cancelableArg,
                             AbstractView viewArg,
                             int detailArg,
                             int screenXArg,
                             int screenYArg,
                             int clientXArg,
                             int clientYArg,
                             short buttonArg,
                             EventTarget relatedTargetArg,
                             String modifiersList)
The initMouseEventNS method is used to initialize the value of a MouseEvent object and has the same behavior as UIEvent.initUIEventNS().

Parameters:
namespaceURI - Refer to the UIEvent.initUIEventNS() method for a description of this parameter.
typeArg - Refer to the UIEvent.initUIEventNS() method for a description of this parameter.
canBubbleArg - Refer to the UIEvent.initUIEventNS() method for a description of this parameter.
cancelableArg - Refer to the UIEvent.initUIEventNS() method for a description of this parameter.
viewArg - Refer to the UIEvent.initUIEventNS() method for a description of this parameter.
detailArg - Refer to the UIEvent.initUIEventNS() method for a description of this parameter.
screenXArg - Refer to the MouseEvent.initMouseEvent() method for a description of this parameter.
screenYArg - Refer to the MouseEvent.initMouseEvent() method for a description of this parameter.
clientXArg - Refer to the MouseEvent.initMouseEvent() method for a description of this parameter.
clientYArg - Refer to the MouseEvent.initMouseEvent() method for a description of this parameter.
buttonArg - Refer to the MouseEvent.initMouseEvent() method for a description of this parameter.
relatedTargetArg - Refer to the MouseEvent.initMouseEvent() method for a description of this parameter.
modifiersList - A white space separated list of modifier key identifiers to be activated on this object. As an example, "Control Alt" will activated the control and alt modifiers.
Since:
DOM Level 3


Copyright © 2009 Apache Software Foundation. All Rights Reserved.