java.util.EventObject
java.awt.AWTEvent
java.awt.event.ComponentEvent
java.awt.event.InputEvent
java.awt.event.MouseEvent
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
| 개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 | |||||||||
java.lang.Object
public class MouseEvent
컴퍼넌트내에서 마우스 액션이 발생한 것을 나타내는 이벤트입니다. 마우스 액션은, 액션 발생시에 마우스 커서가 명시된 컴퍼넌트의 경계상에 있을 때 마셔, 발생했다고 보여집니다. 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 가 불려 가지 않은 경우는, 마우스 모션 이벤트는 컴퍼넌트에 발송 되지 않습니다. 대신에, 마우스 모션 이벤트는, 마우스 모션 이벤트가 유효하게 되어 있는 최초의 상위 컴퍼넌트에 발송 됩니다.
이 이벤트는 컴퍼넌트 객체에 의해 생성되는 저레벨 이벤트이며, 다음의 경우에 생성됩니다.
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 에 관련한 가상 디바이스의 경계내에 넣을 수 있다.
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.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 |
| 필드의 상세 |
|---|
public static final int MOUSE_FIRST
public static final int MOUSE_LAST
public static final int MOUSE_CLICKED
MouseEvent 는, mouse button를 눌러 떼어 놓으면(자) 발생합니다.
public static final int MOUSE_PRESSED
MouseEvent 는, mouse button를 누르면(자) 발생합니다.
public static final int MOUSE_RELEASED
MouseEvent 는, mouse button를 떼어 놓으면(자) 발생합니다.
public static final int MOUSE_MOVED
MouseEvent 는, 마우스의 위치를 변경하면(자) 발생합니다.
public static final int MOUSE_ENTERED
MouseEvent 는, 마우스 커서가 컴퍼넌트의 기하학적 도형의 명시된 영역에 들어가면(자) 발생합니다.
public static final int MOUSE_EXITED
MouseEvent 는, 마우스 커서가 컴퍼넌트의 기하학적 도형의 명시된 영역에서 나오면(자) 발생합니다.
public static final int MOUSE_DRAGGED
MouseEvent 는, mouse button를 누르고 있는 동안에 마우스의 위치가 변경되면(자) 발생합니다.
public static final int MOUSE_WHEEL
MouseWheelEvent 뿐입니다. 휠 첨부 마우스의 휠을 회전시키면(자) 발생합니다.
public static final int NOBUTTON
getButton() 에 의해 사용됩니다.
public static final int BUTTON1
getButton() 에 의해 사용되는 mouse button 1 이 없는 것을 나타냅니다.
public static final int BUTTON2
getButton() 에 의해 사용되는 mouse button 2 가 없는 것을 나타냅니다.
public static final int BUTTON3
getButton() 에 의해 사용되는 mouse button 3 이 없는 것을 나타냅니다.
| 생성자 의 상세 |
|---|
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 - 이벤트의 발생원의 Componentid - 이벤트를 특정하는 정수when - 이벤트의 발생시각을 지정하는 long int 치modifiers - 이벤트 발생시에 밀린 수식 키 (Shift, Ctrl,
Alt, 메타 등).
확장된 _DOWN_MASK 또는 이전의 _MASK 수식자의 어느쪽이든을 사용할 필요가 있다.
다만, 양쪽 모두의 모델을 1 개의 이벤트에 혼합해서는 안 된다.
확장 수식자의 사용이
바람직한x - 마우스 위치의 X 좌표 (수평 방향)y - 마우스 위치의 Y 좌표 (수직 방향)clickCount - 이벤트에 관련한 마우스 클릭의 회수popupTrigger - boolean 형. pop-up menu에 대한 이벤트의 경우는
truebutton - 상태가 변경된 mouse button.
NOBUTTON,
BUTTON1,
BUTTON2, 또는
BUTTON3
IllegalArgumentException - 무효인 button 치가
건네받았을 경우
IllegalArgumentException - source 가 null 의 경우
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 - 이벤트의 발생원의 Componentid - 이벤트를 특정하는 정수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 의 경우
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 - 이벤트의 발생원의 Componentid - 이벤트를 특정하는 정수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에 대한 이벤트의 경우는
truebutton - 상태가 변경된 mouse button.
NOBUTTON,
BUTTON1,
BUTTON2, 또는
BUTTON3
IllegalArgumentException - 무효인 button 치가
건네받았을 경우
IllegalArgumentException - source 가 null 의 경우
| 메소드의 상세 |
|---|
public Point getLocationOnScreen()
Point 객체GraphicsConfiguration public int getXOnScreen()
GraphicsConfiguration public int getYOnScreen()
GraphicsConfiguration public int getX()
public int getY()
public Point getPoint()
Point 객체
public void translatePoint(int x,
int y)
x (수평 방향) 및 y (수직 방향)를 가산하는 것으로써, 이벤트의 좌표를 새로운 위치로 이동합니다.
x - 현재의 X 좌표에 가산된다
x (수평 방향)의 값y - 현재의 Y 좌표에 가산된다
y (수직 방향)의 값public int getClickCount()
public int getButton()
NOBUTTON,
BUTTON1,
BUTTON2, 또는
BUTTON3- 도입된 버젼:
- 1.4
public boolean isPopupTrigger()
주:pop-up menu의 트리거는 시스템에 따라서 다릅니다. 따라서, 공통 플랫폼을 적절히 기능시키기 위해서(때문에),mousePressed 및 mouseReleased 의 양쪽 모두로 isPopupTrigger 를 체크할 필요가 있습니다.
public static String getMouseModifiersText(int modifiers)
String 를 돌려줍니다. 이러한 캐릭터 라인은 awt.properties 파일을 변경하는 것으로써 로컬라이즈가 가능합니다.
InputEvent.ALT_MASK 와 InputEvent.BUTTON2_MASK 는 같은 값이 되기 (위해)때문에, 어느 쪽의 수식자에 대해서도 캐릭터 라인 「Alt」가 돌려주어집니다. 같이InputEvent.META_MASK 와 InputEvent.BUTTON3_MASK 는 같은 값이 되기 (위해)때문에, 어느 쪽의 수식자에 대해서도 캐릭터 라인 「Meta」가 돌려주어집니다.
modifiers - 이벤트의 발생시에 밀리고 있었다
수식 키 및 mouse button를 기술하는 수식자 마스크
InputEvent.getModifiersExText(int) public String paramString()
ComponentEvent 내의 paramString
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
| 개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 | |||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.