org.w3c.dom.events

Interface MouseEvent

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

Method Summary
booleangetAltKey()
true if the alt (alternative) key modifier is activated.
shortgetButton()
During mouse events caused by the depression or release of a mouse button, button is used to indicate which mouse button changed state.
intgetClientX()
The horizontal coordinate at which the event occurred relative to the DOM implementation's client area.
intgetClientY()
The vertical coordinate at which the event occurred relative to the DOM implementation's client area.
booleangetCtrlKey()
true if the control (Ctrl) key modifier is activated.
booleangetMetaKey()
true if the meta (Meta) key modifier is activated.
booleangetModifierState(String keyIdentifierArg)
This methods queries the state of a modifier using a key identifier.
EventTargetgetRelatedTarget()
Used to identify a secondary EventTarget related to a UI event, depending on the type of event.
intgetScreenX()
The horizontal coordinate at which the event occurred relative to the origin of the screen coordinate system.
intgetScreenY()
The vertical coordinate at which the event occurred relative to the origin of the screen coordinate system.
booleangetShiftKey()
true if the shift (Shift) key modifier is activated.
voidinitMouseEvent(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().
voidinitMouseEventNS(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().

Method Detail

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.

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.

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.

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.

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

getRelatedTarget

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

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.

getShiftKey

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

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.

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 B) 2008 Apache Software Foundation. All Rights Reserved.