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

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

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드

## java.awt.event
클래스 InputMethodEvent

    java.lang.Object
      java.util.EventObject
          java.awt.AWTEvent
              java.awt.event.InputMethodEvent

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

    public class InputMethodEvent

extends AWTEvent

입력 메소드 이벤트에는, 입력 메소드를 이용해 변환되고 있는 텍스트에 대한 정보가 포함되어 있습니다. 입력 메소드는, 텍스트가 변경되면(자) 반드시 이벤트를 송신합니다. 현재 입력 메소드를 사용하고 있는 텍스트 컴퍼넌트가 액티브 클라이언트인 경우는, 이벤트는 그 컴퍼넌트에 발송 됩니다. 그 이외의 경우는, 이벤트는 떨어진 변환 윈도우에 발송 됩니다.

입력 메소드 이벤트에 포함되어 있는 텍스트는, 확정 텍스트와 변환 텍스트의 2 개의 부분으로부터 구성되어 있습니다. 어느 쪽의 부분도 빈 상태(empty)의 경우가 있습니다. 2 개의 부분은 함께, 직전의 이벤트로 보내진 미확정의 변환 텍스트, 또는 현재 선택되고 있는 확정 텍스트를 옮겨놓습니다. 확정 텍스트는, 텍스트 컴퍼넌트의 지속적인 데이터에 통합됩니다. 그러면, 재차 송신될 것은 없습니다. 변환 텍스트는, 사용자의 편집 오퍼레이션을 반영하는 변경과 함께, 반복 송신되는 경우가 있습니다. 확정 텍스트는 변환 텍스트보다 항상 우선됩니다.

도입된 버젼:
  1.2
관련 항목:
  직렬화 된 형식

필드의 개요
`static int` | `CARET_POSITION_CHANGED` 입력 메소드 텍스트에서의 삽입 포인트가 변경된 것을 나타내는 이벤트형입니다.
`static int` | `INPUT_METHOD_FIRST` 입력 메소드 이벤트 식별자에 사용하는 정수의 범위에 있는 최초의 번호입니다.
`static int` | `INPUT_METHOD_LAST` 입력 메소드 이벤트 식별자에 사용하는 정수의 범위에 있는 마지막 번호입니다.
`static int` | `INPUT_METHOD_TEXT_CHANGED` 입력 메소드 텍스트가 변경된 것을 나타내는 이벤트형입니다.

클래스 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`

생성자 의 개요
`InputMethodEvent (Component source, int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition)` `InputMethodEvent` 를 구축합니다.
`InputMethodEvent (Component source, int id, long when, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition)` `InputMethodEvent` 를 구축합니다.
`InputMethodEvent (Component source, int id, TextHitInfo caret, TextHitInfo visiblePosition)` `InputMethodEvent` 를 구축합니다.

메소드의 개요
`void` | `consume ()` 이벤트를 소비해, 이벤트가 그 발생 바탕으로보다 디폴트의 방법으로 처리되지 않게 합니다.
`TextHitInfo` | `getCaret ()` caret를 가져옵니다.
`int` | `getCommittedCharacterCount ()` 텍스트내의 확정 텍스트의 문자수를 돌려줍니다.
`AttributedCharacterIterator` | `getText ()` 확정 텍스트와 변환 텍스트를 결합한 것을 돌려줍니다.
`TextHitInfo` | `getVisiblePosition ()` 우선해 가시에 해야 할 위치를 돌려줍니다.
`long` | `getWhen ()` 이 이벤트가 발생한 시점의 타임 스탬프를 돌려줍니다.
`boolean` | `isConsumed ()` 이 이벤트가 소비되었는지의 여부를 돌려줍니다.
`String` | `paramString ()` 이 이벤트를 특정하는 파라미터의 캐릭터 라인을 돌려줍니다.

클래스 java.awt. AWTEvent 로부터 상속된 메소드
`getID , setSource , toString`

클래스 java.util. EventObject 로부터 상속된 메소드
`getSource`

클래스 java.lang. Object 로부터 상속된 메소드
`clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait`

필드의 상세

### INPUT_METHOD_FIRST

    public static final int INPUT_METHOD_FIRST

  입력 메소드 이벤트 식별자에 사용하는 정수의 범위에 있는 최초의 번호입니다.

  관련 항목:
    정수 필드치

### INPUT_METHOD_TEXT_CHANGED

    public static final int INPUT_METHOD_TEXT_CHANGED

  입력 메소드 텍스트가 변경된 것을 나타내는 이벤트형입니다. 이 이벤트는, 입력의 처리중에, 입력 메소드에 의해 생성됩니다.

  관련 항목:
    정수 필드치

### CARET_POSITION_CHANGED

    public static final int CARET_POSITION_CHANGED

  입력 메소드 텍스트에서의 삽입 포인트가 변경된 것을 나타내는 이벤트형입니다. 이 이벤트는, 입력의 처리중으로 caret가 변경되었을 경우에만, 입력 메소드에 의해 생성됩니다.

  관련 항목:
    정수 필드치

### INPUT_METHOD_LAST

    public static final int INPUT_METHOD_LAST

  입력 메소드 이벤트 식별자에 사용하는 정수의 범위에 있는 마지막 번호입니다.

  관련 항목:
    정수 필드치

생성자 의 상세

### InputMethodEvent

    public InputMethodEvent(Component  source,
                            int id,
                            long when,
                            AttributedCharacterIterator  text,
                            int committedCharacterCount,
                            TextHitInfo  caret,
                            TextHitInfo  visiblePosition)

  `InputMethodEvent` 를 구축합니다. 이 때, 이벤트의 발생원의 컴퍼넌트, 형태, 시각, 텍스트, caret, 및 visiblePosition 를 지정합니다.

  caret와 visiblePosition 의 오프셋(offset)는, 현재의 변환 텍스트와의 상대 위치에서 지정됩니다. 즉,`INPUT_METHOD_TEXT_CHANGED` 이벤트의 경우는 `text` 내의 변환 텍스트, 그 이외의 경우는 선행하는 `INPUT_METHOD_TEXT_CHANGED` 이벤트의 `text` 내의 변환 텍스트가 됩니다.

  무효인 `id` 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 이 메소드는 `source` 가 `null` 의 경우에 `IllegalArgumentException` 를 throw 합니다.

  파라미터:
    `source` - 이벤트의 발생원객체
    `id` - 이벤트의 형태
    `when` - 이벤트가 발생한 시간을 지정하는 long 정수
    `text` - 확정 텍스트와 변환 텍스트를 맞춘 것. 확정 텍스트가 우선된다. 이벤트형이 `CARET_POSITION_CHANGED` 의 경우는 `null`, `INPUT_METHOD_TEXT_CHANGED` 이벤트의 경우는, 확정 텍스트 또는 변환 텍스트가 없을 때는 `null`
    `committedCharacterCount` - 텍스트내의 확정된 문자의 수
    `caret` - caret (삽입 포인트). 현재의 변환 텍스트에 caret가 존재하지 않는 경우는 `null`
    `visiblePosition` - 우선해 가시에 해야 할 위치. 현재의 변환 텍스트내에, 가시에 해야 할 위치에 대한 지정이 없는 경우는 `null`
  예외:
    `IllegalArgumentException` - `id` 가 `INPUT_METHOD_FIRST`..`INPUT_METHOD_LAST` 의 범위에 없는 경우, id 가 `CARET_POSITION_CHANGED` 로 `text` 가 `null` 가 아닌 경우, 또는 `committedCharacterCount` 가 `0`..`(text.getEndIndex() - text.getBeginIndex())` 의 범위에 없는 경우
    `IllegalArgumentException` - `source` 가 null 의 경우
  도입된 버젼:
    1.4

### InputMethodEvent

    public InputMethodEvent(Component  source,
                            int id,
                            AttributedCharacterIterator  text,
                            int committedCharacterCount,
                            TextHitInfo  caret,
                            TextHitInfo  visiblePosition)

  `InputMethodEvent` 를 구축합니다. 이 때, 이벤트 발생원의 컴퍼넌트, 형태, 텍스트, caret, 및 visiblePosition 를 지정합니다.

  caret와 visiblePosition 의 오프셋(offset)는, 현재의 변환 텍스트와의 상대 위치에서 지정됩니다. 즉,`INPUT_METHOD_TEXT_CHANGED` 이벤트의 경우는 `text` 내의 변환 텍스트, 그 이외의 경우는 선행하는 `INPUT_METHOD_TEXT_CHANGED` 이벤트의 `text` 내의 변환 텍스트가 됩니다. 이 이벤트의 타임 스탬프는,`EventQueue.getMostRecentEventTime()` 호출하는 것으로 초기화됩니다.

  무효인 `id` 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 이 메소드는 `source` 가 `null` 의 경우에 `IllegalArgumentException` 를 throw 합니다.

  파라미터:
    `source` - 이벤트의 발생원객체
    `id` - 이벤트의 형태
    `text` - 확정 텍스트와 변환 텍스트를 맞춘 것. 확정 텍스트가 우선된다. 이벤트형이 `CARET_POSITION_CHANGED` 의 경우는 `null`, `INPUT_METHOD_TEXT_CHANGED` 이벤트의 경우는, 확정 텍스트 또는 변환 텍스트가 없을 때는 `null`
    `committedCharacterCount` - 텍스트내의 확정된 문자의 수
    `caret` - caret (삽입 포인트). 현재의 변환 텍스트에 caret가 존재하지 않는 경우는 `null`
    `visiblePosition` - 우선해 가시에 해야 할 위치. 현재의 변환 텍스트내에, 가시에 해야 할 위치에 대한 지정이 없는 경우는 `null`
  예외:
    `IllegalArgumentException` - `id` 가 `INPUT_METHOD_FIRST`..`INPUT_METHOD_LAST` 의 범위에 없는 경우, id 가 `CARET_POSITION_CHANGED` 로 `text` 가 `null` 가 아닌 경우, 또는 `committedCharacterCount` 가 `0`..`(text.getEndIndex() - text.getBeginIndex())` 의 범위에 없는 경우
    `IllegalArgumentException` - `source` 가 null 의 경우

### InputMethodEvent

    public InputMethodEvent(Component  source,
                            int id,
                            TextHitInfo  caret,
                            TextHitInfo  visiblePosition)

  `InputMethodEvent` 를 구축합니다. 이 때, 이벤트의 발생원의 컴퍼넌트, 형태, caret, 및 visiblePosition 를 지정합니다. 텍스트는 `null`,`committedCharacterCount` 는 0 으로 설정합니다.

  `caret` 와 `visiblePosition` 의 오프셋(offset)는, 현재의 변환 텍스트를 기준으로 합니다. 즉, 이벤트가 `CARET_POSITION_CHANGED` 으로서 구축되었을 경우는, 선행하는 `INPUT_METHOD_TEXT_CHANGED` 이벤트의 `text` 내의 변환 텍스트가 됩니다. `INPUT_METHOD_TEXT_CHANGED` 에 텍스트가 존재하지 않는 경우,`caret` 와 `visiblePosition` 는 `null` 가 아니면 안됩니다. 이 이벤트의 타임 스탬프는,`EventQueue.getMostRecentEventTime()` 호출하는 것으로 초기화됩니다.

  무효인 `id` 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 이 메소드는 `source` 가 `null` 의 경우에 `IllegalArgumentException` 를 throw 합니다.

  파라미터:
    `source` - 이벤트의 발생원객체
    `id` - 이벤트의 형태
    `caret` - caret (삽입 포인트). 현재의 변환 텍스트에 caret가 존재하지 않는 경우는 `null`
    `visiblePosition` - 우선해 가시에 해야 할 위치. 현재의 변환 텍스트내에, 가시에 해야 할 위치에 대한 지정이 없는 경우는 `null`
  예외:
    `IllegalArgumentException` - `id` 가 `INPUT_METHOD_FIRST`..`INPUT_METHOD_LAST` 의 범위에 없는 경우
    `IllegalArgumentException` - `source` 가 null 의 경우

메소드의 상세

### getText

    public AttributedCharacterIterator  getText()

  확정 텍스트와 변환 텍스트를 결합한 것을 돌려줍니다. 인덱스가 0 ~ `getCommittedCharacterCount() - 1` 까지의 문자가 확정된 텍스트로, 나머지의 문자가 변환 텍스트입니다.

  반환값:
    텍스트. CARET_POSITION_CHANGED 이벤트의 경우는 항상 null, INPUT_METHOD_TEXT_CHANGED 이벤트의 경우는, 변환 텍스트 또는 확정 텍스트가 없을 때는 null

### getCommittedCharacterCount

    public int getCommittedCharacterCount()

  텍스트내의 확정 텍스트의 문자수를 돌려줍니다.

### getCaret

    public TextHitInfo  getCaret()

  caret를 가져옵니다.

  caret의 오프셋(offset)는, 현재의 변환 텍스트에 대한 상대치입니다. 이 경우의 변환 텍스트는, 이벤트가 `INPUT_METHOD_TEXT_CHANGED` 의 경우는 getText() 내의 변환 텍스트, 그 이외의 경우는 선행하는 `INPUT_METHOD_TEXT_CHANGED` 이벤트의 getText() 내의 변환 텍스트가 됩니다.

  반환값:
    caret (삽입 포인트). 현재의 변환 텍스트에 caret가 존재하지 않는 경우는 null

### getVisiblePosition

    public TextHitInfo  getVisiblePosition()

  우선해 가시에 해야 할 위치를 돌려줍니다.

  가시의 위치의 오프셋(offset)는, 현재의 변환 텍스트와의 상대 위치에서 지정됩니다. 즉,`INPUT_METHOD_TEXT_CHANGED` 이벤트의 경우는, getText() 내의 변환 텍스트가 됩니다. 그 이외의 경우는, 선행하는 `INPUT_METHOD_TEXT_CHANGED` 이벤트의 getText() 내의 변환 텍스트입니다.

  반환값:
    우선해 가시에 해야 할 위치. 현재의 변환 텍스트내에, 가시에 해야 할 위치에 대한 지정이 없는 경우는 null

### consume

    public void consume()

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

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

### isConsumed

    public boolean isConsumed()

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

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

### getWhen

    public long getWhen()

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

  반환값:
    이 이벤트의 타임 스탬프
  도입된 버젼:
    1.4

### paramString

    public String  paramString()

  이 이벤트를 특정하는 파라미터의 캐릭터 라인을 돌려줍니다. 이 메소드는, 이벤트 로그의 작성 및 디버그에 사용합니다. 캐릭터 라인에는, 텍스트 형식의 이벤트 식별자, 「+」에 의해 단락지어진 확정 텍스트 및 변환 텍스트의 문자, 확정 텍스트의 문자수, caret, 가시 위치가 포함되어 있습니다.

  오버라이드(override):
    클래스 `AWTEvent` 내의 `paramString`
  반환값:
    이벤트를 특정하는 캐릭터 라인과 그 속성

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 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 도 참조해 주세요.