InputMethodEvent (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

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

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

java.awt.event
클래스 InputMethodEvent

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

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

public class InputMethodEvent
extends AWTEvent
extends AWTEvent

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

인풋 메서드 이벤트에 포함되어 있는 텍스트는 확정 텍스트와 변환 텍스트의 2개의 부분으로부터 구성되어 있습니다. 어느 쪽의 부분도 비어있는 경우가 있습니다. 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.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, 가시 위값이 포함되어 있습니다.