org.w3c.dom.events
인터페이스 MouseEvent

모든 슈퍼 인터페이스:

Event, UIEvent

public interface MouseEvent
extends UIEvent 

MouseEvent인터페이스는 마우스 이벤트에 관련된 고유의 컨텍스트 정보를 제공합니다.

UIEvent로 부터 상속되는 detail 속성은 사용자 액션의 사이에 화면의 같은 위치에서 mouse button를 눌러 떼어 놓는 회수를 나타냅니다. 이 액션을 개시할 때의 속성값는 1 으로 눌러 떼어 놓는 일련의 동작이 완전하게 행해질 때마다 값이 1 증가합니다. 마우스 다운해 마우스 올라가는 동안에 마우스를 작동시키면 값은 0 으로 설정되어 클릭되어 있지 않은 것이 나타납니다.

상자로 된 요소의 경우, 마우스 이벤트는 항상, 제일 깊게 상자로 된 요소를 타겟으로 합니다. 타겟으로 된 요소의 상위 요소는 바브 링을 사용해 그 하위 요소내에서 발생하는 마우스 이벤트의 통지를 취득합니다.

「Document Object Model (DOM) Level 2 Events Specification」도 참조하십시오.

도입된 버전 :

DOM Level 2

필드 개요

인터페이스 org.w3c.dom.events. Event 로부터 상속된 필드

AT_TARGET, BUBBLING_PHASE, CAPTURING_PHASE

메서드 개요

boolean	getAltKey () 이벤트의 트리거중에 「Alt」키가 밀리고 있었는지 어떠했는지를 나타내는 경우에 사용합니다.
short	getButton () mouse button를 누르거나 놓거나 하는 것으로 마우스 이벤트가 발생하고 있는 동안은, button을 사용해, 어느 mouse button 상태가 변경되었는지를 나타냅니다.
int	getClientX () DOM 구현의 클라이언트 영역에 대해서 이벤트가 발생한 위치의 수평 좌표입니다.
int	getClientY () DOM 구현의 클라이언트 영역에 대해서 이벤트가 발생한 위치의 수직 좌표입니다.
boolean	getCtrlKey () 이벤트의 트리거중에 「Ctrl」키가 밀리고 있었는지 어떠했는지를 나타내는 경우에 사용합니다.
boolean	getMetaKey () 이벤트의 트리거중에 「Meta」키가 밀리고 있었는지 어떠했는지를 나타내는 경우에 사용합니다.
EventTarget	getRelatedTarget () UI 이벤트에 관련된 2 차의 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

메서드의 상세

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()

mouse button를 누르거나 놓거나 하는 것으로 마우스 이벤트가 발생하고 있는 동안은, button을 사용해, 어느 mouse button 상태가 변경되었는지를 나타냅니다. button값의 범위는 마우스의 왼쪽 버튼을 나타내는 0, 중앙의 버튼 (존재하는 경우)을 나타내는 1, 오른쪽 버튼을 나타내는 2 입니다. 왼손잡이용으로 구성된 마우스의 경우, 버튼 액션은 역으로 값은 오른쪽에서 왼쪽의 순서가 됩니다.

getRelatedTarget

EventTarget  getRelatedTarget()

UI 이벤트에 관련된 2 차의 EventTarget을 식별할 경우에 사용합니다. 현재, 이 속성은 마우스 오버 이벤트와 함께 pointing device가 빠진 EventTarget을 나타내거나 마우스 아웃 이벤트와 함께 pointing device가 들어간 EventTarget을 나타내는데 사용되고 있습니다.

initMouseEvent

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값을 초기화할 경우에 사용합니다. 이 메서드는 MouseEvent이 dispatchEvent 메서드를 개입시켜 디스패치 되기 전에 한해 호출합니다 만, 필요한 경우는 초기화할 단계에서 여러 차례 호출되는 일도 있습니다. 여러 차례 불려 갔을 경우는 마지막 호출이 우선됩니다.

파라미터:

typeArg - 이벤트의 형태

canBubbleArg - 이벤트를 버블 할 수 있을지 어떨지

cancelableArg - 이벤트의 디폴트 액션을 억제할 수 있을지 어떨지

viewArg - Event AbstractView

detailArg - Event 마우스의 클릭수

screenXArg - Event 화면상에서의 x 좌표

screenYArg - Event 화면상에서의 y 좌표

clientXArg - Event 클라이언트의 x 좌표

clientYArg - Event 클라이언트의 y 좌표

ctrlKeyArg - Event 사이에 Ctrl 키가 눌렸는지 어떠했는지

altKeyArg - Event 사이에 Alt 키가 눌렸는지 어떠했는지

shiftKeyArg - Event 사이에 Shift 키가 눌렸는지 어떠했는지

metaKeyArg - Event 사이에 Meta 키가 눌렸는지 어떠했는지

buttonArg - Event mouse button

relatedTargetArg - Event에 관련된 EventTarget