MouseEvent (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.awt.event
클래스 MouseEvent

java.lang.Object 
  java.util.EventObject 
      java.awt.AWTEvent 
          java.awt.event.ComponentEvent 
              java.awt.event.InputEvent 
                  java.awt.event.MouseEvent

모든 구현된 인터페이스:: Serializable

알려진 직계 서브 클래스:: MenuDragMouseEvent, MouseWheelEvent

public class MouseEvent
extends InputEvent
extends InputEvent

컴퍼넌트내에서 마우스 액션이 발생한 것을 나타내는 이벤트입니다. 마우스 액션은 액션 발생시에 마우스 커서가 명시된 컴퍼넌트의 경계상에 있을 때 마셔, 발생했다고 보여집니다. 컴퍼넌트의 경계는 가시적인 컴퍼넌트의자식, 메뉴, 또는 최상정도 윈도우에 의해 비표시로 할 수 있습니다. 이 이벤트는 마우스 이벤트 (클릭 및 컴퍼넌트에의 출입) 및 마우스 모션 이벤트 (이동과 드래그)의 양쪽 모두로 사용됩니다.

이 이벤트는 컴퍼넌트 객체에 의해 생성되는 저레벨 이벤트이며, 다음의 경우에 생성됩니다.

마우스 이벤트
- mouse button를 누른다
- mouse button를 떼어 놓는다
- mouse button를 클릭한다 (누르고 나서 떼어 놓는다)
- 마우스 커서가 컴퍼넌트의 지오메트리의 명시된 경계 부분에 들어간다
- 마우스 커서가 컴퍼넌트의 지오메트리의 명시된 경계 부분에서 나온다
마우스 모션 이벤트
- 마우스를 이동한다
- 마우스를 드래그 한다

MouseEvent객체는 컴퍼넌트의 addMouseListner 메서드를 사용해, 「관련한다」마우스 이벤트를 받도록 등록되어 모든 MouseListener 객체 또는 MouseAdapter 객체에게 건네집니다. MouseAdapter객체는 MouseListener인터페이스를 구현하고 있습니다. 각 리스너 객체는 마우스 이벤트를 포함한 MouseEvent를 취득합니다.

또, MouseEvent객체는 컴퍼넌트의 addMouseMotionListener 메서드를 사용해, 마우스 모션 이벤트를 받도록 등록되어 모든 MouseMotionListener 객체 또는 MouseMotionAdapter 객체에게 건네집니다. MouseMotionAdapter객체는 MouseMotionListener인터페이스를 구현하고 있습니다. 각 리스너 객체는 마우스 모션 이벤트를 포함한 MouseEvent를 취득합니다.

mouse button를 클릭하면 이벤트가 생성되어 등록되어 있는 MouseListener에 보내집니다. 모덜 키 상태는 InputEvent.getModifiers() 및 InputEvent.getModifiersEx()를 사용해 검출할 수 있습니다. InputEvent.getModifiers() 에 의해 리턴된 버튼 마스크는 모든 버튼의 현재 상태가 아니고, 상태가 변경된 버튼만을 반영합니다 (주: ALT_MASK/BUTTON2_MASK 및 META_MASK/BUTTON3_MASK 값이 오버랩 하기 위한, 수식 키가 관련된 마우스 이벤트의 경우는 이것이 항상 들어맞는 것은 아닙니다). 모든 버튼 및 수식 키 상태를 취득하려면, InputEvent.getModifiersEx()를 사용합니다. 상태가 변경된 버튼은 getButton() 에 의해 리턴됩니다 .

예를 들어 마우스의 제 1 버튼을 누르면, 이벤트는 다음의 순서로 송신됩니다.

 id              modifiers    button            MOUSE_PRESSED:  BUTTON1_MASK BUTTON1 MOUSE_RELEASED: BUTTON1_MASK BUTTON1 MOUSE_CLICKED:  BUTTON1_MASK BUTTON1

복수의 mouse button를 눌렀을 경우는 각 버튼의 프레스, 릴리스, 클릭에 대해서 개별의 이벤트가 생성됩니다.

예를 들어 사용자가버튼 1에 이어버튼 2를 눌러, 같은 순서로 버튼을 떼어 놓았을 경우, 다음의 일련의 이벤트가 생성됩니다.

 id              modifiers    button            MOUSE_PRESSED:  BUTTON1_MASK BUTTON1 MOUSE_PRESSED:  BUTTON2_MASK BUTTON2 MOUSE_RELEASED: BUTTON1_MASK BUTTON1 MOUSE_CLICKED:  BUTTON1_MASK BUTTON1 MOUSE_RELEASED: BUTTON2_MASK BUTTON2 MOUSE_CLICKED:  BUTTON2_MASK BUTTON2

버튼 2를 먼저 떼어 놓았을 경우에는 BUTTON2_MASK MOUSE_RELEASED/MOUSE_CLICKED 페어가 먼저 생성되어 그 후에 BUTTON1_MASK MOUSE_RELEASED/MOUSE_CLICKED 페어가 생성됩니다.

MOUSE_DRAGGED 이벤트는 마우스의 버튼을 떼어 놓을 때까지, 마우스의 버튼이 눌려진Component에 (마우스의 위값이 그 Component 경계내에 있을지 어떨지에 관계없이) 계속해 보내집니다. 드래그＆드롭의 구현은 플랫폼에 따라서 다르기 때문에 네이티브의 드래그＆드롭의 조작중에 MOUSE_DRAGGED 이벤트는 전송 되지 않습니다. 멀티스크린 환경의 경우에는 마우스의 위값이 이 Component에 관련한 GraphicsConfiguration 경계의 외측에 있는 경우에서도, 마우스 드래그 이벤트는 Component에 보내집니다. 다만, 이 경우에 마우스 드래그 이벤트로 보고되는 마우스의 위치는 실제의 마우스의 위치와 다른 일이 있습니다.

가상 디바이스를 보관 유지하지 않는 멀티스크린 환경의 경우:
마우스 드래그 이벤트로 보고된 좌표는 클리핑 되어Component에 관련한 GraphicsConfiguration 경계내에 넣을 수 있다
가상 디바이스를 보관 유지하는 멀티스크린 환경의 경우:
마우스 드래그 이벤트로 보고된 좌표는 클리핑 되어Component에 관련한 가상 디바이스의 경계내에 넣을 수 있다

도입된 버전 :: 1.1
관련 항목:: MouseAdapter, MouseListener, MouseMotionAdapter, MouseMotionListener, MouseWheelListener, Tutorial: Writing a Mouse Listener, Tutorial: Writing a Mouse Motion Listener, Reference: The Java Class Libraries (update file), 직렬화 된 형식

필드 개요
`static int`	`BUTTON1` `getButton()` 에 의해 사용되는 mouse button 1 이 없는 것을 나타냅니다.
`static int`	`BUTTON2` `getButton()` 에 의해 사용되는 mouse button 2가 없는 것을 나타냅니다.
`static int`	`BUTTON3` `getButton()` 에 의해 사용되는 mouse button 3 이 없는 것을 나타냅니다.
`static int`	`MOUSE_CLICKED` 「마우스 클릭」이벤트입니다.
`static int`	`MOUSE_DRAGGED` 「마우드랏그」이벤트입니다.
`static int`	`MOUSE_ENTERED` 「마우스엔타」이벤트입니다.
`static int`	`MOUSE_EXITED` 「마우스이그짓트」이벤트입니다.
`static int`	`MOUSE_FIRST` 마우스 이벤트 식별자의 범위를 나타내는 최초의 번호입니다.
`static int`	`MOUSE_LAST` 마우스 이벤트 식별자의 범위를 나타내는 마지막 번호입니다.
`static int`	`MOUSE_MOVED` 「마우슴브」이벤트입니다.
`static int`	`MOUSE_PRESSED` 「마우스 프레스」이벤트입니다.
`static int`	`MOUSE_RELEASED` 「마우스 릴리스」이벤트입니다.
`static int`	`MOUSE_WHEEL` 「마우스 휠」이벤트입니다.
`static int`	`NOBUTTON` `getButton()` 에 의해 사용되는 mouse button가 없는 것을 나타냅니다.

클래스 java.awt.event. InputEvent 로부터 상속된 필드
`ALT_DOWN_MASK, ALT_GRAPH_DOWN_MASK, ALT_GRAPH_MASK, ALT_MASK, BUTTON1_DOWN_MASK, BUTTON1_MASK, BUTTON2_DOWN_MASK, BUTTON2_MASK, BUTTON3_DOWN_MASK, BUTTON3_MASK, CTRL_DOWN_MASK, CTRL_MASK, META_DOWN_MASK, META_MASK, SHIFT_DOWN_MASK, SHIFT_MASK`

클래스 java.awt.event. ComponentEvent 로부터 상속된 필드
`COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN`

클래스 java.awt. AWTEvent 로부터 상속된 필드
`ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK`

클래스 java.awt. AWTEvent 로부터 상속된 필드

ACTION_EVENT_MASK,
 ADJUSTMENT_EVENT_MASK,
 COMPONENT_EVENT_MASK,
 consumed,
 CONTAINER_EVENT_MASK,
 FOCUS_EVENT_MASK,
 HIERARCHY_BOUNDS_EVENT_MASK,
 HIERARCHY_EVENT_MASK,
 id,
 INPUT_METHOD_EVENT_MASK,
 INVOCATION_EVENT_MASK,
 ITEM_EVENT_MASK,
 KEY_EVENT_MASK,
 MOUSE_EVENT_MASK,
 MOUSE_MOTION_EVENT_MASK,
 MOUSE_WHEEL_EVENT_MASK,
 PAINT_EVENT_MASK,
 RESERVED_ID_MAX,
 TEXT_EVENT_MASK,
 WINDOW_EVENT_MASK,
 WINDOW_FOCUS_EVENT_MASK,
 WINDOW_STATE_EVENT_MASK

클래스 java.util. EventObject 로부터 상속된 필드
`source`

생성자 개요
`MouseEvent (Component source, int id, long when, int modifiers, int x, int y, int clickCount, boolean popupTrigger)` 지정된 발생원의 컴퍼넌트, 타입, 수식자, 좌표, 클릭 카운트로`MouseEvent` 객체를 구축합니다.
`MouseEvent (Component source, int id, long when, int modifiers, int x, int y, int clickCount, boolean popupTrigger, int button)` 지정된 발생원의 컴퍼넌트, 타입, 수식자, 좌표, 클릭 카운트로`MouseEvent` 객체를 구축합니다.

메서드 개요
`int`	`getButton ()` 상태가 변경된 mouse button가 있는 경우, 그 mouse button를 리턴합니다.
`int`	`getClickCount ()` 이 이벤트에 관련한 마우스 클릭수를 리턴합니다.
`static String`	`getMouseModifiersText (int modifiers)` 이벤트의 발생시에 밀리고 있던 「Shift 키」나 「Ctrl+Shift 키」등의 수식 키나 mouse button를 기술하는 `String`를 리턴합니다.
`Point`	`getPoint ()` 발생원의 컴퍼넌트를 기준으로 하는 이벤트의 상대 x, y 좌표치를 리턴합니다.
`int`	`getX ()` 이벤트가 발생한 위치의 X 좌표를 발생원의 컴퍼넌트에 대한 상대 위치에서 리턴합니다.
`int`	`getY ()` 이벤트가 발생한 위치의 Y 좌표를 발생원의 컴퍼넌트에 대한 상대 위치에서 리턴합니다.
`boolean`	`isPopupTrigger ()` 이 마우스 이벤트가 그 플랫폼의 pop-up menu 트리거 이벤트일지 어떨지를 리턴합니다.
`String`	`paramString ()` 이 이벤트를 특정하는 파라미터의 캐릭터 라인을 리턴합니다.
`void`	`translatePoint (int x, int y)` 지정된 오프셋(offset)의 `x` (수평 방향) 및 `y` (수직 방향)를 가산하는 것으로써, 이벤트의 좌표를 새로운 위치로 이동합니다.

클래스 java.awt.event. InputEvent 로부터 상속된 메서드
`consume, getModifiers, getModifiersEx, getModifiersExText, getWhen, isAltDown, isAltGraphDown, isConsumed, isControlDown, isMetaDown, isShiftDown`

클래스 java.awt.event. ComponentEvent 로부터 상속된 메서드
`getComponent`

클래스 java.awt. AWTEvent 로부터 상속된 메서드
`getID, setSource, toString`

클래스 java.util. EventObject 로부터 상속된 메서드
`getSource`

클래스 java.lang. Object 로부터 상속된 메서드
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

필드의 상세

MOUSE_FIRST

public static final int MOUSE_FIRST

마우스 이벤트 식별자의 범위를 나타내는 최초의 번호입니다.

관련 항목:: 정수 필드값

MOUSE_LAST

public static final int MOUSE_LAST

마우스 이벤트 식별자의 범위를 나타내는 마지막 번호입니다.

관련 항목:: 정수 필드값

MOUSE_CLICKED

public static final int MOUSE_CLICKED

「마우스 클릭」이벤트입니다. 이 MouseEvent는 mouse button를 눌러 떼어 놓으면 발생합니다.

관련 항목:: 정수 필드값

MOUSE_PRESSED

public static final int MOUSE_PRESSED

「마우스 프레스」이벤트입니다. 이 MouseEvent는 mouse button를 누르면 발생합니다.

관련 항목:: 정수 필드값

MOUSE_RELEASED

public static final int MOUSE_RELEASED

「마우스 릴리스」이벤트입니다. 이 MouseEvent는 mouse button를 떼어 놓으면 발생합니다.

관련 항목:: 정수 필드값

MOUSE_MOVED

public static final int MOUSE_MOVED

「마우슴브」이벤트입니다. 이 MouseEvent는 마우스의 위치를 변경하면 발생합니다.

관련 항목:: 정수 필드값

MOUSE_ENTERED

public static final int MOUSE_ENTERED

「마우스엔타」이벤트입니다. 이 MouseEvent는 마우스 커서가 컴퍼넌트의 지오메트리의 명시된 영역에 들어가면 발생합니다.

관련 항목:: 정수 필드값

MOUSE_EXITED

public static final int MOUSE_EXITED

「마우스이그짓트」이벤트입니다. 이 MouseEvent는 마우스 커서가 컴퍼넌트의 지오메트리의 명시된 영역에서 나오면 발생합니다.

관련 항목:: 정수 필드값

MOUSE_DRAGGED

public static final int MOUSE_DRAGGED

「마우드랏그」이벤트입니다. 이 MouseEvent는 mouse button를 누르고 있는 동안에 마우스의 위값이 변경되면 발생합니다.

관련 항목:: 정수 필드값

MOUSE_WHEEL

public static final int MOUSE_WHEEL

「마우스 휠」이벤트입니다. 이것은 MouseWheelEvent 뿐입니다. 휠 첨부 마우스의 휠을 회전시키면 발생합니다.

도입된 버전 :: 1.4
관련 항목:: 정수 필드값

NOBUTTON

public static final int NOBUTTON

getButton() 에 의해 사용되는 mouse button가 없는 것을 나타냅니다.

도입된 버전 :: 1.4
관련 항목:: 정수 필드값

BUTTON1

public static final int BUTTON1

getButton() 에 의해 사용되는 mouse button 1 이 없는 것을 나타냅니다.

도입된 버전 :: 1.4
관련 항목:: 정수 필드값

BUTTON2

public static final int BUTTON2

getButton() 에 의해 사용되는 mouse button 2가 없는 것을 나타냅니다.

도입된 버전 :: 1.4
관련 항목:: 정수 필드값

BUTTON3

public static final int BUTTON3

getButton() 에 의해 사용되는 mouse button 3 이 없는 것을 나타냅니다.

도입된 버전 :: 1.4
관련 항목:: 정수 필드값

생성자 상세

MouseEvent

public MouseEvent(Component  source,
                  int id,
                  long when,
                  int modifiers,
                  int x,
                  int y,
                  int clickCount,
                  boolean popupTrigger,
                  int button)

지정된 발생원의 컴퍼넌트, 타입, 수식자, 좌표, 클릭 카운트로MouseEvent 객체를 구축합니다.

무효인 id를 건네주면, 특정할 수 없는 동작이 발생합니다. 무효인 이벤트를 생성하면 (복수의 old _MASK, 또는 일치하지 않는 수식자/버튼치등을 사용하는 것에 해), 특정할 수 없는 동작이 발생합니다. source가 null인 경우, 이 메서드는 IllegalArgumentException을 Throw 합니다.

파라미터:: source - 이벤트의 발생원의 Component; id - 이벤트를 특정하는 정수; when - 이벤트의 발생시각을 지정하는 long int값; modifiers - 이벤트 발생시에 눌려진수식 키 (Shift, Ctrl, Alt, 메타 등). 확장된 _DOWN_MASK 또는 이전의 _MASK 수식자의 어느쪽이든을 사용할 필요가 있다. 다만, 양쪽 모두의 모델을 1개의 이벤트에 혼합해서는 안 된다. 확장 수식자의 사용이 바람직한; x - 마우스 위치의 X 좌표 (수평 방향); y - 마우스 위치의 Y 좌표 (수직 방향); clickCount - 이벤트에 관련한 마우스 클릭의 회수; popupTrigger - boolean 형. pop-up menu에 대한 이벤트의 경우는 true; button - 상태가 변경된 mouse button. NOBUTTON, BUTTON1, BUTTON2, 또는 BUTTON3
예외:: IllegalArgumentException - 무효인 button값이 건네받았을 경우; IllegalArgumentException - source가 null인 경우
도입된 버전 :: 1.4

MouseEvent

public MouseEvent(Component  source,
                  int id,
                  long when,
                  int modifiers,
                  int x,
                  int y,
                  int clickCount,
                  boolean popupTrigger)

지정된 발생원의 컴퍼넌트, 타입, 수식자, 좌표, 클릭 카운트로MouseEvent 객체를 구축합니다.

무효인 id를 건네주면, 특정할 수 없는 동작이 발생합니다. 이 메서드는 source가 null인 경우에 IllegalArgumentException을 Throw 합니다.

파라미터:: source - 이벤트의 발생원의 Component; id - 이벤트를 특정하는 정수; when - 이벤트의 발생시각을 지정하는 long int값; modifiers - 이벤트 발생시에 눌려진수식 키 (Shift, Ctrl, Alt, 메타 등). 확장된 _DOWN_MASK 또는 이전의 _MASK 수식자의 어느쪽이든을 사용할 필요가 있다. 다만, 양쪽 모두의 모델을 1개의 이벤트에 혼합해서는 안 된다. 확장 수식자의 사용이 바람직한; x - 마우스 위치의 X 좌표 (수평 방향); y - 마우스 위치의 Y 좌표 (수직 방향); clickCount - 이벤트에 관련한 마우스 클릭의 회수; popupTrigger - boolean 형. pop-up menu에 대한 이벤트의 경우는 true
예외:: IllegalArgumentException - source가 null인 경우

메서드의 상세

getX

public int getX()

이벤트가 발생한 위치의 X 좌표를 발생원의 컴퍼넌트에 대한 상대 위치에서 리턴합니다.

반환값:: x 컴퍼넌트를 기준으로 하는 수평 위치를 나타내는 정수

getY

public int getY()

이벤트가 발생한 위치의 Y 좌표를 발생원의 컴퍼넌트에 대한 상대 위치에서 리턴합니다.

반환값:: y 컴퍼넌트를 기준으로 하는 수직 위치를 나타내는 정수

getPoint

public Point  getPoint()

발생원의 컴퍼넌트를 기준으로 하는 이벤트의 상대 x, y 좌표치를 리턴합니다.

반환값:: 발생원의 컴퍼넌트를 기준으로 하는 X 좌표 및 Y 좌표를 보관 유지하는 Point 객체

translatePoint

public void translatePoint(int x,
                           int y)

지정된 오프셋(offset)의 x (수평 방향) 및 y (수직 방향)를 가산하는 것으로써, 이벤트의 좌표를 새로운 위치로 이동합니다.

파라미터:: x - 현재의 X 좌표에 가산되는 x (수평 방향)의 값; y - 현재의 Y 좌표에 가산되는 y (수직 방향)의 값

getClickCount

public int getClickCount()

이 이벤트에 관련한 마우스 클릭수를 리턴합니다.

반환값:: 클릭수를 나타내는 정수값

getButton

public int getButton()

상태가 변경된 mouse button가 있는 경우, 그 mouse button를 리턴합니다.

반환값:: 정수 NOBUTTON, BUTTON1, BUTTON2, 또는BUTTON3 어느쪽이든
도입된 버전 :: 1.4

isPopupTrigger

public boolean isPopupTrigger()

이 마우스 이벤트가 그 플랫폼의 pop-up menu 트리거 이벤트일지 어떨지를 리턴합니다.

주: pop-up menu의 트리거는 시스템에 따라서 다릅니다. 따라서, 공통 플랫폼을 적절히 기능시키기 위해서 mousePressed 및 mouseReleased 양쪽 모두로 isPopupTrigger를 체크할 필요가 있습니다.

반환값:: boolean 형. 이벤트가 이 플랫폼의 pop-up menu 트리거 이벤트인 경우는 true

getMouseModifiersText

public static String  getMouseModifiersText(int modifiers)

이벤트의 발생시에 밀리고 있던 「Shift 키」나 「Ctrl+Shift 키」등의 수식 키나 mouse button를 기술하는 String를 리턴합니다. 이러한 캐릭터 라인은 awt.properties 파일을 변경하는 것으로써 지역 대응이 가능합니다.

InputEvent.ALT_MASK와 InputEvent.BUTTON2_MASK는 같은 값이 되기 때문에 어느 쪽의 수식자에 대해서도 캐릭터 라인 「Alt」가 리턴됩니다 . 같이InputEvent.META_MASK와 InputEvent.BUTTON3_MASK는 같은 값이 되기 때문에 어느 쪽의 수식자에 대해서도 캐릭터 라인 「Meta」가 리턴됩니다 .

파라미터:: modifiers - 이벤트의 발생시에 밀리고 있던 수식 키 및 mouse button를 기술하는 수식자 마스크
반환값:: 이벤트 발생시에 밀리고 있던 수식 키 및 mouse button의 편성을 기술하는 텍스트 캐릭터 라인
도입된 버전 :: 1.4
관련 항목:: InputEvent.getModifiersExText(int)

paramString

public String  paramString()

이 이벤트를 특정하는 파라미터의 캐릭터 라인을 리턴합니다. 이 메서드는 이벤트 로그의 작성 및 디버그에 사용합니다.

오버라이드(override):: 클래스 ComponentEvent 내의 paramString

반환값:: 이벤트를 특정하는 캐릭터 라인과 그 속성

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.awt.event 클래스 MouseEvent

MOUSE_FIRST

MOUSE_LAST

MOUSE_CLICKED

MOUSE_PRESSED

MOUSE_RELEASED

MOUSE_MOVED

MOUSE_ENTERED

MOUSE_EXITED

MOUSE_DRAGGED

MOUSE_WHEEL

NOBUTTON

BUTTON1

BUTTON2

BUTTON3

MouseEvent

MouseEvent

getX

getY

getPoint

translatePoint

getClickCount

getButton

isPopupTrigger

getMouseModifiersText

paramString

java.awt.event
클래스 MouseEvent