java.awt.event
클래스 InputMethodEvent

java.lang.Object 
  |
  +--java.util.EventObject 
        |
        +--java.awt.AWTEvent 
              |
              +--java.awt.event.InputMethodEvent

모든 구현 인터페이스:

Serializable

public class InputMethodEvent

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.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 내의 변환 텍스트가 됩니다.

파라미터:

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()) 의 범위에 없는 경우

도입된 버젼:

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() 를 호출하는 것으로 초기화됩니다.

파라미터:

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()) 의 범위에 없는 경우

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() 호출하는 것으로 초기화됩니다.

파라미터:

source - 이벤트의 발생원오브젝트

id - 이벤트의 타입

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

visiblePosition - 우선해 가시에 해야 할 위치. 현재의 변환 텍스트내에, 가시로 하는 위치의 지정이 존재하지 않는 경우는 null

예외:

IllegalArgumentException - id 가 INPUT_METHOD_FIRST..INPUT_METHOD_LAST 의 범위내에 없는 경우

메소드의 상세

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

반환값:

이벤트 및 그 속성을 특정하는 캐릭터 라인