AWTKeyStroke (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.awt
클래스 AWTKeyStroke

java.lang.Object 
  java.awt.AWTKeyStroke

모든 구현된 인터페이스:: Serializable

알려진 직계 서브 클래스:: KeyStroke

public class AWTKeyStroke
extends Object
implements Serializable
extends Object
implements Serializable

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

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)` 지정된 문자 객체와 수식자세트를 가지는 `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 팩토리 메서드가 사용하는 새로운 클래스를 등록합니다. 이 메서드를 호출한 후, 팩토리 메서드는 지정된 클래스의 인스턴스를 리턴합니다. 지정하는 클래스는 AWTKeyStroke 나 AWTKeyStroke로 부터 취득된 것의 어느 쪽인지로 인수 없음의 생성자를 가지지 않으면 안됩니다. 생성자 액세스 가능성은 임의이며, 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)

지정된 문자 객체와 수식자세트를 가지는 AWTKeyStroke 공유 인스턴스를 리턴합니다. 최초의 파라미터에는 char 형은 아니고, 문자형을 사용합니다. 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

이전 사용되고 있던 수식자를 다음에 듭니다.

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 - keyChar가 null인 경우
관련 항목:: 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

파라미터:: 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

파라미터:: 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 - s가 null인지, 포맷이 올바르지 않은 경우

getKeyChar

public final char getKeyChar()

이 AWTKeyStroke 문자를 리턴합니다.

반환값:: char값
관련 항목:: getAWTKeyStroke(char)

getKeyCode

public final int getKeyCode()

이 AWTKeyStroke 수치 키코드를 리턴합니다.

반환값:: 키코드값이 포함되고 있는 int값
관련 항목:: getAWTKeyStroke(int, int)

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

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.awt 클래스 AWTKeyStroke

AWTKeyStroke

AWTKeyStroke

registerSubclass

getAWTKeyStroke

getAWTKeyStroke

getAWTKeyStroke

getAWTKeyStroke

getAWTKeyStrokeForEvent

getAWTKeyStroke

getKeyChar

getKeyCode

getModifiers

isOnKeyRelease

getKeyEventType

hashCode

equals

toString

readResolve

java.awt
클래스 AWTKeyStroke