AWTKeyStroke (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

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_PRESSED` 나 `KEY_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` 의 팩토리 메소드가 사용하는 새로운 클래스를 등록합니다. 이 메소드를 호출한 후, 팩토리 메소드는 지정된 클래스의 인스턴스를 돌려줍니다. 지정하는 클래스는 `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)

  지정된 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` - `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
  이것들도 사용할 수 있습니다만, 이것들은 _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` - `s` 가 `null` 인지, 포맷이 올바르지 않은 경우

### 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`

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

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