JavaTM Platform
Standard Ed. 6

java.awt.event
클래스 InputEvent

java.lang.Object 
  상위를 확장 java.util.EventObject 
      상위를 확장 java.awt.AWTEvent 
          상위를 확장 java.awt.event.ComponentEvent 
              상위를 확장 java.awt.event.InputEvent
모든 구현된 인터페이스:
Serializable
직계의 기존의 서브 클래스:
KeyEvent , MouseEvent


public abstract class InputEvent
extends ComponentEvent

전컴퍼넌트 레벨의 입력 이벤트의 루트 이벤트 클래스입니다. 입력 이벤트는, 작성된 소스에 의해 정상적으로 처리되기 전에 청취자에게 보내집니다. 이것에 의해, 청취자와 컴퍼넌트 서브 클래스는 이벤트를 「소비」해, 소스가 디폴트의 방법으로 이벤트를 처리하지 않게 할 수 있습니다. 예를 들어, Button 컴퍼넌트의 mousePressed 이벤트를 소비하는 것에 의해, Button 가 기동되지 않게 할 수 있습니다.

도입된 버젼:
1.1
관련 항목:
KeyEvent , KeyAdapter , MouseEvent , MouseAdapter , MouseMotionAdapter , 직렬화 된 형식

필드의 개요
static int ALT_DOWN_MASK
          Alt 키의 확장 정수입니다.
static int ALT_GRAPH_DOWN_MASK
          AltGraph 키의 확장 정수입니다.
static int ALT_GRAPH_MASK
          AltGraph 키의 정수입니다.
static int ALT_MASK
          Alt 키의 정수입니다.
static int BUTTON1_DOWN_MASK
          Mouse Button1 의 확장 정수입니다.
static int BUTTON1_MASK
          Mouse Button1 의 정수입니다.
static int BUTTON2_DOWN_MASK
          Mouse Button2 의 확장 정수입니다.
static int BUTTON2_MASK
          Mouse Button2 의 정수입니다.
static int BUTTON3_DOWN_MASK
          Mouse Button3 의 확장 정수입니다.
static int BUTTON3_MASK
          Mouse Button3 의 정수입니다.
static int CTRL_DOWN_MASK
          Ctrl 키의 확장 정수입니다.
static int CTRL_MASK
          Ctrl 키의 정수입니다.
static int META_DOWN_MASK
          Meta 키의 확장 정수입니다.
static int META_MASK
          Meta 키의 정수입니다.
static int SHIFT_DOWN_MASK
          Shift 키의 확장 정수입니다.
static int SHIFT_MASK
          Shift 키의 정수입니다.
 
클래스 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
 
메소드의 개요
 void consume ()
          이벤트를 소비해, 이벤트가 그 발생 바탕으로보다 디폴트의 방법으로 처리되지 않게 합니다.
 int getModifiers ()
          이 이벤트의 수식자 마스크를 돌려줍니다.
 int getModifiersEx ()
          이 이벤트에 관한 확장 수식자의 마스크를 돌려줍니다.
static String getModifiersExText (int modifiers)
           「Shift」, 「Button1」, 또는 「Ctrl+Shift」등의 확장 수식 키 및 mouse button를 기술하는 String 를 돌려줍니다.
 long getWhen ()
          이 이벤트가 발생한 시점의 타임 스탬프를 돌려줍니다.
 boolean isAltDown ()
          이벤트로 Alt 키가 밀리고 있었는지의 여부를 돌려줍니다.
 boolean isAltGraphDown ()
          이벤트로 AltGraph 키가 밀리고 있었는지의 여부를 돌려줍니다.
 boolean isConsumed ()
          이 이벤트가 소비되었는지의 여부를 돌려줍니다.
 boolean isControlDown ()
          이벤트로 Ctrl 키가 밀리고 있었는지의 여부를 돌려줍니다.
 boolean isMetaDown ()
          이벤트로 메타키가 밀리고 있었는지의 여부를 돌려줍니다.
 boolean isShiftDown ()
          이벤트로 Shift 키가 밀리고 있었는지의 여부를 돌려줍니다.
 
클래스 java.awt.event. ComponentEvent 로부터 상속된 메소드
getComponent , paramString
 
클래스 java.awt. AWTEvent 로부터 상속된 메소드
getID , setSource , toString
 
클래스 java.util. EventObject 로부터 상속된 메소드
getSource
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait
 

필드의 상세

SHIFT_MASK

public static final int SHIFT_MASK
Shift 키의 정수입니다. 대신에, SHIFT_DOWN_MASK 를 사용하는 것을 추천합니다.

관련 항목:
정수 필드치

CTRL_MASK

public static final int CTRL_MASK
Ctrl 키의 정수입니다. 대신에, CTRL_DOWN_MASK 를 사용하는 것을 추천합니다.

관련 항목:
정수 필드치

META_MASK

public static final int META_MASK
Meta 키의 정수입니다. 대신에, META_DOWN_MASK 를 사용하는 것을 추천합니다.

관련 항목:
정수 필드치

ALT_MASK

public static final int ALT_MASK
Alt 키의 정수입니다. 대신에, ALT_DOWN_MASK 를 사용하는 것을 추천합니다.

관련 항목:
정수 필드치

ALT_GRAPH_MASK

public static final int ALT_GRAPH_MASK
AltGraph 키의 정수입니다.

관련 항목:
정수 필드치

BUTTON1_MASK

public static final int BUTTON1_MASK
Mouse Button1 의 정수입니다. 대신에, BUTTON1_DOWN_MASK 를 사용하는 것을 추천합니다.

관련 항목:
정수 필드치

BUTTON2_MASK

public static final int BUTTON2_MASK
Mouse Button2 의 정수입니다. 대신에, BUTTON2_DOWN_MASK 를 사용하는 것을 추천합니다. BUTTON2_MASK 의 값은 ALT_MASK 와 같습니다.

관련 항목:
정수 필드치

BUTTON3_MASK

public static final int BUTTON3_MASK
Mouse Button3 의 정수입니다. 대신에, BUTTON3_DOWN_MASK 를 사용하는 것을 추천합니다. BUTTON3_MASK 의 값은 META_MASK 와 같습니다.

관련 항목:
정수 필드치

SHIFT_DOWN_MASK

public static final int SHIFT_DOWN_MASK
Shift 키의 확장 정수입니다.

도입된 버젼:
1.4
관련 항목:
정수 필드치

CTRL_DOWN_MASK

public static final int CTRL_DOWN_MASK
Ctrl 키의 확장 정수입니다.

도입된 버젼:
1.4
관련 항목:
정수 필드치

META_DOWN_MASK

public static final int META_DOWN_MASK
Meta 키의 확장 정수입니다.

도입된 버젼:
1.4
관련 항목:
정수 필드치

ALT_DOWN_MASK

public static final int ALT_DOWN_MASK
Alt 키의 확장 정수입니다.

도입된 버젼:
1.4
관련 항목:
정수 필드치

BUTTON1_DOWN_MASK

public static final int BUTTON1_DOWN_MASK
Mouse Button1 의 확장 정수입니다.

도입된 버젼:
1.4
관련 항목:
정수 필드치

BUTTON2_DOWN_MASK

public static final int BUTTON2_DOWN_MASK
Mouse Button2 의 확장 정수입니다.

도입된 버젼:
1.4
관련 항목:
정수 필드치

BUTTON3_DOWN_MASK

public static final int BUTTON3_DOWN_MASK
Mouse Button3 의 확장 정수입니다.

도입된 버젼:
1.4
관련 항목:
정수 필드치

ALT_GRAPH_DOWN_MASK

public static final int ALT_GRAPH_DOWN_MASK
AltGraph 키의 확장 정수입니다.

도입된 버젼:
1.4
관련 항목:
정수 필드치
메소드의 상세

isShiftDown

public boolean isShiftDown()
이벤트로 Shift 키가 밀리고 있었는지의 여부를 돌려줍니다.


isControlDown

public boolean isControlDown()
이벤트로 Ctrl 키가 밀리고 있었는지의 여부를 돌려줍니다.


isMetaDown

public boolean isMetaDown()
이벤트로 메타키가 밀리고 있었는지의 여부를 돌려줍니다.


isAltDown

public boolean isAltDown()
이벤트로 Alt 키가 밀리고 있었는지의 여부를 돌려줍니다.


isAltGraphDown

public boolean isAltGraphDown()
이벤트로 AltGraph 키가 밀리고 있었는지의 여부를 돌려줍니다.


getWhen

public long getWhen()
이 이벤트가 발생한 시점의 타임 스탬프를 돌려줍니다.


getModifiers

public int getModifiers()
이 이벤트의 수식자 마스크를 돌려줍니다.


getModifiersEx

public int getModifiersEx()
이 이벤트에 관한 확장 수식자의 마스크를 돌려줍니다. 확장 수식자는, 이벤트가 발생한 직후의 Alt, Ctrl, Meta 키나 mouse button 등, 모든 모덜 키 상태를 나타냅니다.

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

    MOUSE_PRESSED:  BUTTON1_DOWN_MASK
    MOUSE_PRESSED:  BUTTON1_DOWN_MASK | BUTTON2_DOWN_MASK
    MOUSE_RELEASED: BUTTON2_DOWN_MASK
    MOUSE_CLICKED:  BUTTON2_DOWN_MASK
    MOUSE_RELEASED: 
    MOUSE_CLICKED:  
 

향후, 새로운 수식자가 추가될 가능성이 있기 (위해)때문에,== 를 사용해 이 메소드의 반환값을 비교하는 것은 추천 되지 않습니다. 예를 들어, 다음의 코드에 의해, Shift 키와 Button 1 을 눌러 Ctrl 키를 떼어 놓은 것을 체크할 수 있습니다.

    int onmask = SHIFT_DOWN_MASK | BUTTON1_DOWN_MASK;
    int offmask = CTRL_DOWN_MASK;
    if ((event.getModifiersEx() & (onmask | offmask)) == onmask) {
        ...
    }
 
상기의 코드는, 새로운 수식자가 추가되어도 동작합니다.

도입된 버젼:
1.4

consume

public void consume()
이벤트를 소비해, 이벤트가 그 발생 바탕으로보다 디폴트의 방법으로 처리되지 않게 합니다.

오버라이드(override):
클래스 AWTEvent 내의 consume

isConsumed

public boolean isConsumed()
이 이벤트가 소비되었는지의 여부를 돌려줍니다.

오버라이드(override):
클래스 AWTEvent 내의 isConsumed
관련 항목:
consume()

getModifiersExText

public static String  getModifiersExText(int modifiers)
「Shift」, 「Button1」, 또는 「Ctrl+Shift」등의 확장 수식 키 및 mouse button를 기술하는 String 를 돌려줍니다. 이러한 캐릭터 라인은 awt.properties 파일을 변경하는 것으로써 로컬라이즈가 가능합니다.

파라미터:
modifiers - 이벤트의 확장 수식 키 및 mouse button를 기술하는 수식자 마스크
반환값:
이벤트 발생시에 밀리고 있었다 확장 수식 키 및 mouse button의 편성을 기술하는 텍스트 캐릭터 라인
도입된 버젼:
1.4

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 도 참조해 주세요.