java.awt.im
인터페이스 InputMethodRequests

알려진 서브 인터페이스 목록 :

InputMethodContext

public interface InputMethodRequests

InputMethodRequests는 인풋 메서드를 취급하기 위해서 텍스트 편집 컴퍼넌트로 처리할 필요가 있는 요구를 정의합니다. 컴퍼넌트는 이 인터페이스 자체를 구현하는 일도, 또는 그 인터페이스를 구현하는 독립한 객체를 사용할 수도 있습니다. 이 인터페이스를 구현하는 객체는 컴퍼넌트의 getInputMethodRequests 메서드로부터 돌려주고질 필요가 있습니다.

또, 텍스트 편집 컴퍼넌트는 인풋 메서드의 이벤트 리스너를 제공할 필요가 있습니다.

인터페이스는 다음의 2개의 입력 사용자 인터페이스의 어느쪽이든을 지원하도록 설계됩니다.

• 「온더 스포트 (on-the-spot)」입력. 변환되는 텍스트는 텍스트 컴퍼넌트의 텍스트 본체의 일부로서 표시된다
• 「비로자스폿트 (below-the-spot)」입력. 변환되는 텍스트는 확정시에 텍스트가 삽입되는 삽입 포인트의 바로 아래의, 독립한 변환 윈도우에 표시된다. 컴퍼넌트의 텍스트 본체내에서 텍스트가 선택되고 있는 경우, 이 텍스트는 확정시에 확정된 텍스트로 옮겨진다. 따라서, 텍스트의 입력처가 되는 컨텍스트 의 일부라고는 보여지지 않는다

도입된 버전 :

1.2

관련 항목:

Component.getInputMethodRequests(), InputMethodListener

메서드 개요

AttributedCharacterIterator	cancelLatestCommittedText (AttributedCharacterIterator.Attribute [] attributes) 텍스트 편집 컴퍼넌트로부터 최신의 확정 텍스트를 취득해, 컴퍼넌트의 텍스트 본체로부터 그 텍스트를 삭제합니다.
AttributedCharacterIterator	getCommittedText (int beginIndex, int endIndex, AttributedCharacterIterator.Attribute [] attributes) 미확정의 텍스트를 제외해, 텍스트 편집 컴퍼넌트에 포함되고 있는 텍스트 전체 및 속성에의 액세스를 제공하는 반복자를 리턴합니다.
int	getCommittedTextLength () 미확정의 (변환) 텍스트를 제외한, 텍스트 편집 컴퍼넌트에 포함되고 있는 텍스트 전체의 길이를 리턴합니다.
int	getInsertPositionOffset () 텍스트 편집 컴퍼넌트에 포함되고 있는 확정 텍스트내의 삽입 위치의 오프셋(offset)를 리턴합니다.
TextHitInfo	getLocationOffset (int x, int y) 화면상으로 지정된 절대 x 및 y 좌표의, 변환 텍스트내에서의 오프셋(offset)를 리턴합니다.
AttributedCharacterIterator	getSelectedText (AttributedCharacterIterator.Attribute [] attributes) 텍스트 편집 컴퍼넌트상에서 선택되고 있는 텍스트를 리턴합니다.
Rectangle	getTextLocation (TextHitInfo offset) 현재의 변환 텍스트에서의 지정된 오프셋(offset)의 위치, 또는 확정 텍스트에서의 선택 범위의 위치를 리턴합니다.

메서드의 상세

getTextLocation

Rectangle  getTextLocation(TextHitInfo  offset)

현재의 변환 텍스트에서의 지정된 오프셋(offset)의 위치, 또는 확정 텍스트에서의 선택 범위의 위치를 리턴합니다. 이 정보는 예를 들어 변환 텍스트의 근처에 후보 윈도우를 배치하거나 확정 텍스트의 삽입처의 위치의 근처에 변환 윈도우를 배치하기 위해서 사용됩니다.

컴퍼넌트에 변환 텍스트가 포함되는 (컴퍼넌트에 보내지는 최신의 InputMethodEvent에 변환 텍스트가 포함되기 때문에) 경우, 오프셋(offset)는 변환 텍스트로부터의 상대 위값이 됩니다. 오프셋(offset) 0 은 변환 텍스트의 최초의 문자를 나타내, 리턴된 위치는 이 문자의 위값이 됩니다.

컴퍼넌트가 변환 텍스트를 가지지 않는 경우, 오프셋(offset)는 무시되어 리턴된 위치는 선택 텍스트가 포함되고 있는 맨 마지막 줄내의 하이라이트의 선두 (행방향)가 됩니다. 예를 들어 왼쪽에서 오른쪽에의 가로쓰기의 텍스트 (영어등)에서는 선택 텍스트가 포함되고 있는 맨 마지막 줄의 좌단에 있는 문자의 왼쪽옆의 위값이 리턴됩니다 . 위에서 밑으로의 세로 쓰기의 텍스트로 오른쪽의 행으로부터 왼쪽의 행에 쓰는 경우는 선택한 텍스트가 포함되고 있는 제일왼쪽의 행의 선두의 위값이 리턴됩니다 .

위치는 두께 0 caret로서 나타내집니다. 즉, 텍스트가 횡방향에 렌더링 되는 경우는넓이 0, 텍스트가 세로 방향에 렌더링 되는 경우는 높이 0 이 됩니다. 다른 텍스트 방향의 경우는 세로 방향 또는 횡방향에 매핑 할 필요가 있습니다. 구형은 절대 화면 좌표를 사용합니다.

파라미터:

offset - 변환 텍스트가 있는 경우는 변환 텍스트내에서의 좌표. 그렇지 않은 경우는 null

반환값:

좌표의 화면 위치를 나타내는 구형

getLocationOffset

TextHitInfo  getLocationOffset(int x,
                              int y)

화면상으로 지정된 절대 x 및 y 좌표의, 변환 텍스트내에서의 오프셋(offset)를 리턴합니다. 이 정보는 예를 들어 마우스 클릭 및 마우스 커서를 처리하기 위해서 사용됩니다. 오프셋(offset)는 변환 텍스트에 대한 상대 위치에서 오프셋(offset) 0 은 변환 텍스트의 선두를 나타냅니다.

위값이 변환 텍스트가 차지하는 영역의 밖에 있는 경우는 null을 리턴합니다.

파라미터:

x - 화면상에서의 절대 x 좌표

y - 화면상에서의 절대 y 좌표

반환값:

변환 텍스트내에서의 좌표를 기술하는 텍스트 히트 정보

getInsertPositionOffset

int getInsertPositionOffset()

텍스트 편집 컴퍼넌트에 포함되고 있는 확정 텍스트내의 삽입 위치의 오프셋(offset)를 리턴합니다. 이것은 인풋 메서드를 통해서 입력된 문자의 삽입 위치의 오프셋(offset)입니다. 이 정보는 예를 들어 삽입 위치의 전후의 텍스트를 조사하기 위해서 인풋 메서드에 의해 사용됩니다.

반환값:

삽입 위치의 좌표

getCommittedText

AttributedCharacterIterator  getCommittedText(int beginIndex,
                                             int endIndex,
                                             AttributedCharacterIterator.Attribute [] attributes)

미확정의 텍스트를 제외해, 텍스트 편집 컴퍼넌트에 포함되고 있는 텍스트 전체 및 속성에의 액세스를 제공하는 반복자를 리턴합니다. 미확정의 (변환) 텍스트는 인덱스의 계산에서는 무시되어 반복자를 통해서 액세스 가능하게는 되지 않습니다.

인풋 메서드는 관련된 속성의 리스트를 제공하는 경우가 있습니다. 그 경우, 구현측이 가지는 그 외의 속성에 대한 정보는 반복자를 통해서 액세스 가능하게 할 필요는 없습니다. 속성 리스트가 null인 경우는 이용 가능한 모든 속성 정보를 액세스 가능하게 할 필요가 있습니다.

파라미터:

beginIndex - 최초의 문자의 인덱스

endIndex - 마지막 문자의 후에 계속되는 문자의 인덱스

attributes - 인풋 메서드에 관련된 속성의 리스트

반환값:

텍스트 및 텍스트의 속성에 액세스 할 수 있는 반복자

getCommittedTextLength

int getCommittedTextLength()

미확정의 (변환) 텍스트를 제외한, 텍스트 편집 컴퍼넌트에 포함되고 있는 텍스트 전체의 길이를 리턴합니다.

반환값:

미확정의 텍스트를 제외한 텍스트의 길이

cancelLatestCommittedText

AttributedCharacterIterator  cancelLatestCommittedText(AttributedCharacterIterator.Attribute [] attributes)

텍스트 편집 컴퍼넌트로부터 최신의 확정 텍스트를 취득해, 컴퍼넌트의 텍스트 본체로부터 그 텍스트를 삭제합니다. 이것은 확정 텍스트를 이전의 변환 상태에 되돌리는 일부의 인풋 메서드의 「확정 취소」기능으로 사용됩니다. 변환 텍스트는 InputMethodEvent를 사용해 컴퍼넌트에 보내집니다.

일반적으로 이 기능은 사용자가 텍스트로 다른 오퍼레이션을 실행한 후에는 없고, 텍스트가 확정된 직후에만 지원됩니다. 이 기능이 지원되어 있지 않은 경우는 null을 리턴합니다.

인풋 메서드는 관련된 속성의 리스트를 제공하는 경우가 있습니다. 그 경우, 구현측이 가지는 그 외의 속성에 대한 정보는 반복자를 통해서 액세스 가능하게 할 필요는 없습니다. 속성 리스트가 null인 경우는 이용 가능한 모든 속성 정보를 액세스 가능하게 할 필요가 있습니다.

파라미터:

attributes - 인풋 메서드에 관련된 속성의 리스트

반환값:

최신의 확정 텍스트, 또는 null ( 「확정 취소」기능이 지원되어 있지 않은 경우)

getSelectedText

AttributedCharacterIterator  getSelectedText(AttributedCharacterIterator.Attribute [] attributes)

텍스트 편집 컴퍼넌트상에서 선택되고 있는 텍스트를 리턴합니다. 이것은 다양한 목적으로 사용됩니다. 1개의 예로서 일부의 인풋 메서드의 「재변환」기능이 있습니다. 이 경우 인풋 메서드는 인풋 메서드 이벤트를 보내, 선택되고 있는 텍스트를 변환 텍스트에 옮겨놓습니다. 인풋 메서드의 기능에 응해, 이것은 선택 텍스트에 대응하는 원의 변환 텍스트, 텍스트내에 마지막에 입력된 변환 텍스트, 또는 선택 텍스트를 바탕으로 되돌린 텍스트가 될 수도 있습니다.

인풋 메서드는 관련된 속성의 리스트를 제공하는 경우가 있습니다. 그 경우, 구현측이 가지는 그 외의 속성에 대한 정보는 반복자를 통해서 액세스 가능하게 할 필요는 없습니다. 속성 리스트가 null인 경우는 이용 가능한 모든 속성 정보를 액세스 가능하게 할 필요가 있습니다.

파라미터:

attributes - 인풋 메서드에 관련된 속성의 리스트

반환값:

현재 선택되고 있는 텍스트