MouseEvent (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드

## 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

컴퍼넌트내에서 마우스 액션이 발생한 것을 나타내는 이벤트입니다. 마우스 액션은, 액션 발생시에 마우스 커서가 명시된 컴퍼넌트의 경계상에 있을 때 마셔, 발생했다고 보여집니다. Swing 의 컴퍼넌트와 같은 경량 컴퍼넌트의 경우는, 해당하는 마우스 이벤트형이 컴퍼넌트로 유효하게 되어 있는 경우만, 마우스 이벤트가 컴퍼넌트에 발송 됩니다. 마우스 이벤트형을 유효하게 하려면 , 대응하는 마우스 베이스의 `EventListener` 를 컴퍼넌트에 추가하는지 (`MouseListener` 또는 `MouseMotionListener` ), 대응하는 마스크 파라미터 (`AWTEvent.MOUSE_EVENT_MASK` 또는 `AWTEvent.MOUSE_MOTION_EVENT_MASK`)를 지정해 `Component.enableEvents(long)` 를 호출합니다. 마우스 이벤트형이 컴퍼넌트로 유효하게 되지 않은 경우, 대응하는 마우스 이벤트는, 그 마우스 이벤트형이 유효하게 되어 있는 최초의 상위 컴퍼넌트에 발송 됩니다.

예를 들어,`MouseListener` 를 컴퍼넌트에 추가했는지,`enableEvents(AWTEvent.MOUSE_EVENT_MASK)` 를 호출했을 경우는,`MouseListener` 로 정의 떠날 수 있어 모든 이벤트가 컴퍼넌트에 발송 됩니다. 한편,`MouseMotionListener` 가 추가되지 않고,`AWTEvent.MOUSE_MOTION_EVENT_MASK` 를 지정해 `enableEvents` 가 불려 가지 않은 경우는, 마우스 모션 이벤트는 컴퍼넌트에 발송 되지 않습니다. 대신에, 마우스 모션 이벤트는, 마우스 모션 이벤트가 유효하게 되어 있는 최초의 상위 컴퍼넌트에 발송 됩니다.

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

- 마우스 이벤트
  - 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」, 직렬화 된 형식

필드의 개요
`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` 어느 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.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` 객체를 구축합니다.
`MouseEvent (Component source, int id, long when, int modifiers, int x, int y, int xAbs, int yAbs, int clickCount, boolean popupTrigger, int button)` 지정된 발생원의 컴퍼넌트, 타입, 수식자, 좌표, 절대 좌표, 클릭 카운트로,`MouseEvent` 객체를 구축합니다.

메소드의 개요
`int` | `getButton ()` 상태가 변경된 mouse button가 있는 경우, 그 mouse button를 돌려줍니다.
`int` | `getClickCount ()` 이 이벤트에 관련한 마우스 클릭수를 돌려줍니다.
`Point` | `getLocationOnScreen ()` 이벤트의 절대 x, y 좌표를 돌려줍니다.
`static String` | `getMouseModifiersText (int modifiers)` 이벤트의 발생시에 밀리고 있던 「Shift 키」나 「Ctrl+Shift 키」등의 수식 키나 mouse button를 기술하는 `String` 를 돌려줍니다.
`Point` | `getPoint ()` 발생원의 컴퍼넌트를 기준으로 하는, 이벤트의 상대 x, y 좌표치를 돌려줍니다.
`int` | `getX ()` 이벤트가 발생한 위치의 X 좌표를 발생원의 컴퍼넌트에 대한 상대 위치에서 돌려줍니다.
`int` | `getXOnScreen ()` 이벤트의 절대 x 좌표 (수평 방향)를 돌려줍니다.
`int` | `getY ()` 이벤트가 발생한 위치의 Y 좌표를 발생원의 컴퍼넌트에 대한 상대 위치에서 돌려줍니다.
`int` | `getYOnScreen ()` 이벤트의 절대 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

  어느 mouse button도 해당하지 않는 것을 나타냅니다. `getButton()` 에 의해 사용됩니다.

  도입된 버젼:
    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, 또는 일치하지 않는 수식자/버튼치등을 사용하는 것에 의해), 특정할 수 없는 동작이 발생합니다. ``MouseEvent(source, id, when, modifiers, x, y, clickCount, popupTrigger, button)` 의 형식에서 호출했을 경우,``MouseEvent` (source, id, when, modifiers, x, y, xAbs, yAbs, clickCount, popupTrigger, button)` 의 호출과 완전히 똑같이 동작합니다. 이 xAbs 와 yAbs 는, 화면상의 발생원컴퍼넌트의 위치에 상대 좌표 x 와 y 를 가산한 값으로 해서 정의됩니다. 발생원컴퍼넌트가 표시되어 있지 않은 경우, xAbs 와 yAbs 는 0 으로 설정됩니다. 이 메소드는 `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` 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. `MouseEvent(source, id, when, modifiers, x, y, clickCount, popupTrigger)` 의 형식에서 호출했을 경우,``MouseEvent` (source, id, when, modifiers, x, y, xAbs, yAbs, clickCount, popupTrigger, MouseEvent.NOBUTTON)` 의 호출과 완전히 똑같이 동작합니다. 이 xAbs 와 yAbs 는, 화면상의 발생원컴퍼넌트의 위치에 상대 좌표 x 와 y 를 가산한 값으로 해서 정의됩니다. 발생원컴퍼넌트가 표시되어 있지 않은 경우, xAbs 와 yAbs 는 0 으로 설정됩니다. 이 메소드는 `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 의 경우

### MouseEvent

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

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

  무효인 `id` 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 무효인 이벤트를 생성하면(자) (복수의 old _MASK, 또는 일치하지 않는 수식자/버튼치등을 사용하는 것에 의해), 특정할 수 없는 동작이 발생합니다. `생성자 에게 건네진 상대 좌표와 절대 좌표의 값이 모순되고 있는 경우에서도 MouseEvent 인스턴스는 작성되어 예외는 throw 되지 않습니다. 이 메소드는 `source` 가 `null` 의 경우에 `IllegalArgumentException` 를 throw 합니다.`

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

메소드의 상세

### getLocationOnScreen

    public Point  getLocationOnScreen()

  이벤트의 절대 x, y 좌표를 돌려줍니다. 데스크탑 영역이 물리적으로 복수의 화면 디바이스에 걸치는 가상 디바이스의 멀티스크린 환경에서는, 이러한 좌표는 가상의 좌표계를 기준으로 하고 있습니다. 그 이외의 경우, 이러한 좌표는, 컴퍼넌트의 GraphicsConfiguration 에 관련지을 수 있었던 좌표계를 기준으로 하고 있습니다.

  반환값:
    절대 X 좌표와 절대 Y 좌표를 보관 유지하는 `Point` 객체
  도입된 버젼:
    1.6
  관련 항목:
    `GraphicsConfiguration`

### getXOnScreen

    public int getXOnScreen()

  이벤트의 절대 x 좌표 (수평 방향)를 돌려줍니다. 데스크탑 영역이 물리적으로 복수의 화면 디바이스에 걸치는 가상 디바이스의 멀티스크린 환경에서는, 이 좌표는 가상의 좌표계를 기준으로 하고 있습니다. 그 이외의 경우, 이 좌표는, 컴퍼넌트의 GraphicsConfiguration 에 관련지을 수 있었던 좌표계를 기준으로 하고 있습니다.

  반환값:
    x 수평 방향의 절대 위치를 나타내는 정수
  도입된 버젼:
    1.6
  관련 항목:
    `GraphicsConfiguration`

### getYOnScreen

    public int getYOnScreen()

  이벤트의 절대 y 좌표 (수직 방향)를 돌려줍니다. 데스크탑 영역이 물리적으로 복수의 화면 디바이스에 걸치는 가상 디바이스의 멀티스크린 환경에서는, 이 좌표는 가상의 좌표계를 기준으로 하고 있습니다. 그 이외의 경우, 이 좌표는, 컴퍼넌트의 GraphicsConfiguration 에 관련지을 수 있었던 좌표계를 기준으로 하고 있습니다.

  반환값:
    y 수직 방향의 절대 위치를 나타내는 정수
  도입된 버젼:
    1.6
  관련 항목:
    `GraphicsConfiguration`

### 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 | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.