JavaTM Platform
Standard Ed. 6

java.awt
클래스 AWTKeyStroke

java.lang.Object 
  상위를 확장 java.awt.AWTKeyStroke
모든 구현된 인터페이스:
Serializable
직계의 기존의 서브 클래스:
KeyStroke


public class AWTKeyStroke
extends Object
implements Serializable

AWTKeyStroke 는, 키보드, 또는 동등의 입력 디바이스의 키 액션을 나타냅니다. KEY_PRESSEDKEY_RELEASED KeyEvent 와 같이, 특정의 키를 누르거나 떼어 놓거나 하는 동작에게만 대응해,KEY_TYPED KeyEvent 와 같이, 특정의 Java 문자의 입력을 대응시킬 수도 있습니다. 어떠한 경우에서도,AWTKeyStroke 에서는, 액션을 정확하게 일치시키기 위해서(때문에) 필요한 수식자 (Alt, Shift, Control, Meta, AltGraph 의 각 키, 또는 이러한 키의 편성)를 지정할 수 있습니다.  

AWTKeyStrokes 는 불변이며, 중복 하지 않는 것을 상정하고 있습니다. 이 때문에, 클라이언트 코드로 독자적인 AWTKeyStroke 를 정의하지 않고,getAWTKeyStroke 의 파생 함수를 사용합니다. 이러한 팩토리 메소드를 클라이언트로 사용하면(자),AWTKeyStroke 의 구현으로, 인스턴스의 효율적인 캐쉬와 공유가 가능합니다.

도입된 버젼:
1.4
관련 항목:
getAWTKeyStroke(char) , 직렬화 된 형식

생성자 의 개요
protected AWTKeyStroke ()
          디폴트 값로 AWTKeyStroke 를 구축합니다.
protected AWTKeyStroke (char keyChar, int keyCode, int modifiers, boolean onKeyRelease)
          지정된 값으로 AWTKeyStroke 를 구축합니다.
 
메소드의 개요
 boolean equals (Object  anObject)
          이 객체가 지정된 객체와 같은 경우에 true 를 돌려줍니다.
static AWTKeyStroke getAWTKeyStroke (char keyChar)
          지정된 문자의 KEY_TYPED 이벤트를 표현하는,AWTKeyStroke 의 공유 인스턴스를 돌려줍니다.
static AWTKeyStroke getAWTKeyStroke (Character  keyChar, int modifiers)
          지정된 Character 객체와 수식자세트의 KEY_TYPED 이벤트를 표현하는,AWTKeyStroke 의 공유 인스턴스를 돌려줍니다.
static AWTKeyStroke getAWTKeyStroke (int keyCode, int modifiers)
          지정된 수치 키코드와 수식자세트를 가지는,AWTKeyStroke 의 공유 인스턴스를 돌려줍니다.
static AWTKeyStroke getAWTKeyStroke (int keyCode, int modifiers, boolean onKeyRelease)
          밀렸을 때, 또는 해제되었을 때의 어느 쪽의 경우에 키가 유효하게 되는지를 지정해, 지정된 수치 키코드와 수식자세트를 가지는,AWTKeyStroke 의 공유 인스턴스를 돌려줍니다.
static AWTKeyStroke getAWTKeyStroke (String  s)
          캐릭터 라인의 구문을 해석해,AWTKeyStroke 를 돌려줍니다.
static AWTKeyStroke getAWTKeyStrokeForEvent (KeyEvent  anEvent)
          지정된 KeyEvent 를 생성하는 stroke를 표현하는 AWTKeyStroke 를 돌려줍니다.
 char getKeyChar ()
          이 AWTKeyStroke 의 문자를 돌려줍니다.
 int getKeyCode ()
          이 AWTKeyStroke 의 수치 키코드를 돌려줍니다.
 int getKeyEventType ()
          이 AWTKeyStroke 에 대응하는 KeyEvent 의 형태를 돌려줍니다.
 int getModifiers ()
          이 AWTKeyStroke 의 수식자 키를 돌려줍니다.
 int hashCode ()
          일의이다고 생각되는 이 객체의 수치를 돌려줍니다.
 boolean isOnKeyRelease ()
          이 AWTKeyStroke 가 키를 떼어 놓는 조작을 표현할지 어떨지를 돌려줍니다.
protected  Object readResolve ()
          이 인스턴스와 같은,AWTKeyStroke 의 캐쉬된 인스턴스, 또는 AWTKeyStroke 의 서브 클래스를 돌려줍니다.
protected static void registerSubclass (Class <? > subclass)
          AWTKeyStroke 의 새로운 인스턴스를 생성할 경우에,AWTKeyStroke 의 팩토리 메소드가 사용하는 새로운 클래스를 등록합니다.
 String toString ()
          이 객체의 프로퍼티을 표시 및 식별하는 캐릭터 라인을 돌려줍니다.
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , finalize , getClass , notify , notifyAll , wait , wait , wait
 

생성자 의 상세

AWTKeyStroke

protected AWTKeyStroke()
디폴트 값로 AWTKeyStroke 를 구축합니다. 다음의 디폴트 값를 사용합니다.
프로퍼티디폴트 값
키 문자 KeyEvent.CHAR_UNDEFINED
키코드 KeyEvent.VK_UNDEFINED
수식자 없음
키를 떼어 놓는 동작의 표현 false
AWTKeyStroke 는 클라이언트 코드로 구축해야 하는 것이 아닙니다. 대신에,getAWTKeyStroke 의 파생 함수를 사용해 주세요.

관련 항목:
getAWTKeyStroke(char)

AWTKeyStroke

protected AWTKeyStroke(char keyChar,
                       int keyCode,
                       int modifiers,
                       boolean onKeyRelease)
지정된 값으로 AWTKeyStroke 를 구축합니다. AWTKeyStroke 는 클라이언트 코드로 구축해야 하는 것이 아닙니다. 대신에,getAWTKeyStroke 의 파생 함수를 사용해 주세요.

파라미터:
keyChar - 키보드의 키의 문자치
keyCode - 이 AWTKeyStroke 의 키코드
modifiers - 수식자의 비트 단위의 논리합
onKeyRelease - 이 AWTKeyStroke 가 키를 떼어 놓는 동작에 대응하는 경우는 true, 그렇지 않은 경우는 false
관련 항목:
getAWTKeyStroke(char)
메소드의 상세

registerSubclass

protected static void registerSubclass(Class <? > subclass)
AWTKeyStroke 의 새로운 인스턴스를 생성할 경우에,AWTKeyStroke 의 팩토리 메소드가 사용하는 새로운 클래스를 등록합니다. 이 메소드를 호출한 후, 팩토리 메소드는 지정된 클래스의 인스턴스를 돌려줍니다. 지정하는 클래스는 AWTKeyStrokeAWTKeyStroke 로부터 취득된 것의 어느 쪽인지로, 인수 없음의 생성자 을 가지지 않으면 안됩니다. 생성자 의 액세스 가능성은 임의이며,private 에서도 상관하지 않습니다. 이 조작은 현재의 AWTKeyStroke 캐쉬를 플래시 합니다.

파라미터:
subclass - 팩토리 메소드가 인스턴스를 생성한다 새로운 클래스
예외:
IllegalArgumentException - 서브 클래스가 null 인지, 또는 인수 없음의 생성자 을 가지지 않는 경우
ClassCastException - 서브 클래스가 AWTKeyStroke 가 아닌 경우, 또는 AWTKeyStroke 로부터 파생한 클래스가 아닌 경우

getAWTKeyStroke

public static AWTKeyStroke  getAWTKeyStroke(char keyChar)
지정된 문자의 KEY_TYPED 이벤트를 표현하는,AWTKeyStroke 의 공유 인스턴스를 돌려줍니다.

파라미터:
keyChar - 키보드의 키의 문자치
반환값:
상기 키의 AWTKeyStroke 객체

getAWTKeyStroke

public static AWTKeyStroke  getAWTKeyStroke(Character  keyChar,
                                           int modifiers)
지정된 Character 객체와 수식자세트의 KEY_TYPED 이벤트를 표현하는,AWTKeyStroke 의 공유 인스턴스를 돌려줍니다. 최초의 파라미터는 char 형은 아니고 Character 형의 파라미터입니다. getAWTKeyStroke(int keyCode, int modifiers) 의 호출로, 부주의로 발생하는 크래쉬를 피할 수가 있습니다. 수식자는, 다음의 편성으로 구성됩니다.
  • java.awt.event.InputEvent.SHIFT_DOWN_MASK
  • java.awt.event.InputEvent.CTRL_DOWN_MASK
  • java.awt.event.InputEvent.META_DOWN_MASK
  • java.awt.event.InputEvent.ALT_DOWN_MASK
  • java.awt.event.InputEvent.ALT_GRAPH_DOWN_MASK
다음에 나타내는 낡은 수식자도 사용할 수 있습니다만, 이것들은 _DOWN_ 수식자에 매핑 됩니다.
  • java.awt.event.InputEvent.SHIFT_MASK
  • java.awt.event.InputEvent.CTRL_MASK
  • java.awt.event.InputEvent.META_MASK
  • java.awt.event.InputEvent.ALT_MASK
  • java.awt.event.InputEvent.ALT_GRAPH_MASK
이것들도 사용할 수 있습니다만, 이것들은 _DOWN_ 수식자에 매핑 됩니다. 이러한 숫자는 모두 다른 2 의 누승이기 (위해)때문에, 그러한 편성은 각 비트가 다른 수식 키를 나타내는 정수입니다. 수식자를 지정하지 않는 경우는, 0 을 사용합니다.

파라미터:
keyChar - 키보드 문자의 Character 객체
modifiers - 수식자의 비트 단위의 논리합
반환값:
상기 키의 AWTKeyStroke 객체
예외:
IllegalArgumentException - keyCharnull 의 경우
관련 항목:
InputEvent

getAWTKeyStroke

public static AWTKeyStroke  getAWTKeyStroke(int keyCode,
                                           int modifiers,
                                           boolean onKeyRelease)
밀렸을 때, 또는 해제되었을 때의 어느 쪽의 경우에 키가 유효하게 되는지를 지정해, 지정된 수치 키코드와 수식자세트를 가지는,AWTKeyStroke 의 공유 인스턴스를 돌려줍니다.  

java.awt.event.KeyEvent 로 정의되는 「가상 키」정수는, 키코드를 지정하기 위해서 사용할 수 있습니다. 다음에 예를 나타냅니다.

  • java.awt.event.KeyEvent.VK_ENTER
  • java.awt.event.KeyEvent.VK_TAB
  • java.awt.event.KeyEvent.VK_SPACE
수식자는, 다음의 편성으로 구성됩니다.
  • java.awt.event.InputEvent.SHIFT_DOWN_MASK
  • java.awt.event.InputEvent.CTRL_DOWN_MASK
  • java.awt.event.InputEvent.META_DOWN_MASK
  • java.awt.event.InputEvent.ALT_DOWN_MASK
  • java.awt.event.InputEvent.ALT_GRAPH_DOWN_MASK
이전 사용되고 있던 수식자를 다음에 듭니다.
  • java.awt.event.InputEvent.SHIFT_MASK
  • java.awt.event.InputEvent.CTRL_MASK
  • java.awt.event.InputEvent.META_MASK
  • java.awt.event.InputEvent.ALT_MASK
  • java.awt.event.InputEvent.ALT_GRAPH_MASK
이것들도 사용할 수 있습니다만, 이것들은 _DOWN_ 수식자에 매핑 됩니다. 이러한 숫자는 모두 다른 2 의 누승이기 (위해)때문에, 그러한 편성은 각 비트가 다른 수식 키를 나타내는 정수입니다. 수식자를 지정하지 않는 경우는, 0 을 사용합니다.

파라미터:
keyCode - 키보드의 키의 수치 코드를 지정하는 int 치
modifiers - 수식자의 비트 단위의 논리합
onKeyRelease - 이 AWTKeyStroke 가 키를 떼어 놓는 동작을 표현하는 경우는 true, 그렇지 않은 경우는 false
반환값:
상기 키의 AWTKeyStroke 객체
관련 항목:
KeyEvent , InputEvent

getAWTKeyStroke

public static AWTKeyStroke  getAWTKeyStroke(int keyCode,
                                           int modifiers)
지정된 수치 키코드와 수식자세트를 가지는,AWTKeyStroke 의 공유 인스턴스를 돌려줍니다. 반환된 AWTKeyStroke 는 키를 누르는 액션에 대응합니다.  

java.awt.event.KeyEvent 로 정의되는 「가상 키」정수는, 키코드를 지정하기 위해서 사용할 수 있습니다. 다음에 예를 나타냅니다.

  • java.awt.event.KeyEvent.VK_ENTER
  • java.awt.event.KeyEvent.VK_TAB
  • java.awt.event.KeyEvent.VK_SPACE
수식자는, 다음의 편성으로 구성됩니다.
  • java.awt.event.InputEvent.SHIFT_DOWN_MASK
  • java.awt.event.InputEvent.CTRL_DOWN_MASK
  • java.awt.event.InputEvent.META_DOWN_MASK
  • java.awt.event.InputEvent.ALT_DOWN_MASK
  • java.awt.event.InputEvent.ALT_GRAPH_DOWN_MASK
이전 사용되고 있던 수식자를 다음에 듭니다.
  • java.awt.event.InputEvent.SHIFT_MASK
  • java.awt.event.InputEvent.CTRL_MASK
  • java.awt.event.InputEvent.META_MASK
  • java.awt.event.InputEvent.ALT_MASK
  • java.awt.event.InputEvent.ALT_GRAPH_MASK
이것들도 사용할 수 있습니다만, 이것들은 _DOWN_ 수식자에 매핑 됩니다. 이러한 숫자는 모두 다른 2 의 누승이기 (위해)때문에, 그러한 편성은 각 비트가 다른 수식 키를 나타내는 정수입니다. 수식자를 지정하지 않는 경우는, 0 을 사용합니다.

파라미터:
keyCode - 키보드의 키의 수치 코드를 지정하는 int 치
modifiers - 수식자의 비트 단위의 논리합
반환값:
상기 키의 AWTKeyStroke 객체
관련 항목:
KeyEvent , InputEvent

getAWTKeyStrokeForEvent

public static AWTKeyStroke  getAWTKeyStrokeForEvent(KeyEvent  anEvent)
지정된 KeyEvent 를 생성하는 stroke를 표현하는 AWTKeyStroke 를 돌려줍니다.  

이 메소드는,KeyTyped 이벤트로부터 keyChar 를,KeyPressed 또는 KeyReleased 이벤트로부터 keyCode 를 가져옵니다. KeyEvent 수식자는,KeyEvent 의 3 개의 형태 모두로부터 취득됩니다.

파라미터:
anEvent - AWTKeyStroke 를 취득한다 KeyEvent
반환값:
이벤트를 발생시킨 AWTKeyStroke
예외:
NullPointerException - anEvent 가 null 의 경우

getAWTKeyStroke

public static AWTKeyStroke  getAWTKeyStroke(String  s)
캐릭터 라인의 구문을 해석해,AWTKeyStroke 를 돌려줍니다. 캐릭터 라인은 다음의 구문을 가질 필요가 있습니다.
    <modifiers>* (<typedID> | <pressedReleasedID>)

    modifiers := shift | control | ctrl | meta | alt | altGraph 
    typedID := typed <typedKey>
    typedKey := string of length 1 giving Unicode character.
    pressedReleasedID := (pressed | released) key
    key := KeyEvent key code name, i.e.  the name following "VK_".
 
타이프 치는지, 누르는지, 떼어 놓는지가 지정되지 않는 경우, 누른다고 보여집니다. 몇개인가예를 듭니다.
     "INSERT" => getAWTKeyStroke(KeyEvent.VK_INSERT, 0);
     "control DELETE" => getAWTKeyStroke(KeyEvent.VK_DELETE, InputEvent.CTRL_MASK);
     "alt shift X" => getAWTKeyStroke(KeyEvent.VK_X, InputEvent.ALT_MASK | InputEvent.SHIFT_MASK);
     "alt shift released X" => getAWTKeyStroke(KeyEvent.VK_X, InputEvent.ALT_MASK | InputEvent.SHIFT_MASK, true);
     "typed a" => getAWTKeyStroke('a');
 

파라미터:
s - 상기의 구문에 따라 지정한 String
반환값:
상기 캐릭터 라인의 AWTKeyStroke 객체
예외:
IllegalArgumentException - snull 인지, 포맷이 올바르지 않은 경우

getKeyChar

public final char getKeyChar()
AWTKeyStroke 의 문자를 돌려줍니다.

반환값:
char 값
관련 항목:
getAWTKeyStroke(char) , KeyEvent.getKeyChar()

getKeyCode

public final int getKeyCode()
AWTKeyStroke 의 수치 키코드를 돌려줍니다.

반환값:
키코드값가 포함되고 있는 int 치
관련 항목:
getAWTKeyStroke(int, int) , KeyEvent.getKeyCode()

getModifiers

public final int getModifiers()
AWTKeyStroke 의 수식자 키를 돌려줍니다.

반환값:
수식자가 포함되고 있는 int 치
관련 항목:
getAWTKeyStroke(int, int)

isOnKeyRelease

public final boolean isOnKeyRelease()
AWTKeyStroke 가 키를 떼어 놓는 조작을 표현할지 어떨지를 돌려줍니다.

반환값:
AWTKeyStroke 가 키를 떼어 놓는 동작을 표현하는 경우는 true, 그렇지 않은 경우는 false
관련 항목:
getAWTKeyStroke(int, int, boolean)

getKeyEventType

public final int getKeyEventType()
AWTKeyStroke 에 대응하는 KeyEvent 의 형태를 돌려줍니다.

반환값:
KeyEvent.KEY_PRESSED, KeyEvent.KEY_TYPED, 또는 KeyEvent.KEY_RELEASED
관련 항목:
KeyEvent

hashCode

public int hashCode()
일의이다고 생각되는 이 객체의 수치를 돌려줍니다. 이 값은, 해시 테이블로 인덱스치로서 사용할 수 있습니다.

오버라이드(override):
클래스 Object 내의 hashCode
반환값:
이 객체를 나타내는 int 치
관련 항목:
Object.equals(java.lang.Object) , Hashtable

equals

public final boolean equals(Object  anObject)
이 객체가 지정된 객체와 같은 경우에 true 를 돌려줍니다.

오버라이드(override):
클래스 Object 내의 equals
파라미터:
anObject - 이 객체와 비교하는 Object
반환값:
객체가 같은 경우는 true
관련 항목:
Object.hashCode() , Hashtable

toString

public String  toString()
이 객체의 프로퍼티을 표시 및 식별하는 캐릭터 라인을 돌려줍니다. 이 메소드로부터 반환된 String 를 파라미터로서 getAWTKeyStroke(String) 에 건네주어, 이 키스트로크(keystroke)에 동일한 키스트로크(keystroke)를 생성합니다.

오버라이드(override):
클래스 Object 내의 toString
반환값:
이 객체의 캐릭터 라인 표현
관련 항목:
getAWTKeyStroke(String)

readResolve

protected Object  readResolve()
                      throws ObjectStreamException 
이 인스턴스와 같은,AWTKeyStroke 의 캐쉬된 인스턴스, 또는 AWTKeyStroke 의 서브 클래스를 돌려줍니다.

반환값:
이 인스턴스와 같은, 캐쉬된 인스턴스
예외:
ObjectStreamException

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