|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
java.lang.Object
|
+--java.util.EventObject
|
+--java.awt.AWTEvent
|
+--java.awt.event.ComponentEvent
|
+--java.awt.event.InputEvent
|
+--java.awt.event.MouseEvent
컴퍼넌트내에서 마우스 액션이 발생한 것을 나타내는 이벤트입니다. 마우스 액션은 액션 발생시에 마우스 커서가 명시된 컴퍼넌트의 경계상에 있을 때 마셔, 발생했다고 보여집니다. 컴퍼넌트의 경계는 가시적인 컴퍼넌트의 아이, 메뉴, 또는 최상정도 윈도우에 의해 비표시로 할 수 있습니다. 이 이벤트는 마우스 이벤트 (클릭 및 컴퍼넌트에의 출입) 및 마우스 모션 이벤트 (이동과 드러그)의 양쪽 모두로 사용됩니다.
이 이벤트는 컴퍼넌트 오브젝트에 의해 생성되는 저레벨 이벤트이며, 다음의 경우에 생성됩니다.
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 의 값이 오버랩 하기 위한(해), 수식 키가 관련하는 마우스 이벤트의 경우, 이것은 항상 true 가 아닙니다). 상태가 변경된 버튼은 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 의 경계내에 있을지 어떨지에 관계없이, mouse button를 누르고 나서 떼어 놓기까지 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」,
「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.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 키」등의 수식 키를 기술하는 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 |
| 필드의 상세 |
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
MouseMotionEvent 는 마우스의 위치를 변경하면(자) 발생합니다.
public static final int MOUSE_ENTERED
MouseEvent 는 마우스 커서가 컴퍼넌트의 지오메트리의 명시된 area에 들어가면(자) 발생합니다.
public static final int MOUSE_EXITED
MouseEvent 는 마우스 커서가 컴퍼넌트의 지오메트리의 명시된 area로부터 나오면(자) 발생합니다.
public static final int NOBUTTON
getButton() 따라 사용되는 mouse button가 없는 것을 나타냅니다.
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 static final int MOUSE_DRAGGED
MouseMotionEvent 는 mouse button를 누르고 있는 동안에 마우스의 위치가 변경되면(자) 발생합니다.
public static final int MOUSE_WHEEL
MouseWheelEvent 뿐입니다. 휠 첨부 마우스의 휠을 회전시키면(자) 발생합니다.
| 생성자의 상세 |
public MouseEvent(Component source,
int id,
long when,
int modifiers,
int x,
int y,
int clickCount,
boolean popupTrigger,
int button)
MouseEvent 오브젝트를 구축합니다.
무효인 id 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요.
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 치가 건네받았을 경우
public MouseEvent(Component source,
int id,
long when,
int modifiers,
int x,
int y,
int clickCount,
boolean popupTrigger)
MouseEvent 오브젝트를 구축합니다.
무효인 id 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요.
source - 이벤트의 발생원의 Componentid - 이벤트를 특정하는 정수when - 이벤트의 발생시각을 지정하는 long int 치modifiers - 이벤트 발생시에 밀린 수식 키 (Shift, Ctrl, Alt, 메타 등). 확장된 _DOWN_MASK 또는 이전의 _MASK 수식자의 어느쪽이든을 사용할 필요가 있다. 다만, 양쪽 모두의 모델을 1 개의 이벤트에 혼합해서는 안 된다. 확장 수식자의 사용이 바람직하다. x - 마우스 위치의 X 좌표 (수평 방향)y - 마우스 위치의 Y 좌표 (수직 방향)clickCount - 이벤트에 관련한 마우스 클릭의 회수popupTrigger - boolean 형. pop-up menu에 대한 이벤트의 경우는 true| 메소드의 상세 |
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()
public boolean isPopupTrigger()
주: pop-up menu의 방아쇠는 시스템에 따라서 다릅니다. 따라서, 공통 플랫폼을 적절히 기능시키기 위해서(때문에),mousePressed 및 mouseReleased 의 양쪽 모두로 isPopupTrigger 를 체크할 필요가 있습니다.
public static String getMouseModifiersText(int modifiers)
public String paramString()
ComponentEvent 내의 paramString
|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.