java.awt.im.spi
인터페이스 InputMethodContext

모든 슈퍼 인터페이스:

InputMethodRequests

public interface InputMethodContext
extends InputMethodRequests 

인풋 메서드가 그 클라이언트 컴퍼넌트와의 통신 또는 다른 서비스의 요구를 위해서 사용할 수 있는 메서드를 제공합니다. 이 인터페이스는 인풋 메서드 체제에 의해 구현되어 인풋 메서드가 InputMethod.setInputMethodContext(java.awt.im.spi.InputMethodContext) 로부터 받는 인스턴스의 메서드를 호출합니다. 이외의 구현자 또는 호출해 원래는 없습니다.

도입된 버전 :

1.3

메서드 개요

JFrame	createInputMethodJFrame (String title, boolean attachToInputContext) 인풋 메서드가 사용하는 톱 레벨의 Swing JFrame를 작성합니다.
Window	createInputMethodWindow (String title, boolean attachToInputContext) 인풋 메서드가 사용하는 톱 레벨의 윈도우를 작성합니다.
void	dispatchInputMethodEvent (int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition) 지정된 인수로 인풋 메서드 이벤트를 작성해, 그 이벤트를 클라이언트 컴퍼넌트에 디스패치 합니다.
void	enableClientWindowNotification (InputMethod inputMethod, boolean enable) 지정된 인풋 메서드에 대한 현재의 클라이언트 윈도우의 위치 및 상태의 통지를 사용 가능 또는 사용 불가능하게 합니다.

인터페이스 java.awt.im. InputMethodRequests 로부터 상속된 메서드

cancelLatestCommittedText, getCommittedText, getCommittedTextLength, getInsertPositionOffset, getLocationOffset, getSelectedText, getTextLocation

메서드의 상세

dispatchInputMethodEvent

void dispatchInputMethodEvent(int id,
                              AttributedCharacterIterator  text,
                              int committedCharacterCount,
                              TextHitInfo  caret,
                              TextHitInfo  visiblePosition)

지정된 인수로 인풋 메서드 이벤트를 작성해, 그 이벤트를 클라이언트 컴퍼넌트에 디스패치 합니다. 인수에 대해서는 InputMethodEvent.InputMethodEvent(java.awt.Component, int, java.awt.font.TextHitInfo, java.awt.font.TextHitInfo)를 참조하십시오.

createInputMethodWindow

Window  createInputMethodWindow(String  title,
                               boolean attachToInputContext)

인풋 메서드가 사용하는 톱 레벨의 윈도우를 작성합니다. 이 윈도우의 동작을 다음에 나타냅니다.

• 모든 document window와 다이얼로그 위에 표시한다
• 윈도우와 그 중의 모든 컴퍼넌트는 포커스를 받지 않는다
• 타이틀이 없는 축소 드래그 영역과 같은 경량의 장식을 보관 유지한다

다만, 이러한 3개의 항목에 관한 실제의 동작은 플랫폼에 존하고 있습니다.

타이틀이 표시 또는 비표시가 될까는 작성된 윈도우의 실제의 타입에 의존합니다.

attachToInputContext가 true인 경우, 새로운 윈도우는 이 인풋 메서드 컨텍스트에 대응한 입력 컨텍스트를 공유할 수 있습니다. 이것에 의해 윈도우에 있는 컴퍼넌트의 이벤트는 자동적으로 그 인풋 메서드에 디스패치 됩니다. 게다가 setVisible(true)를 사용해 윈도우를 열고 있을 때는 입력 컨텍스트에 의해 다른 방법에 따르는 인풋 메서드에의 종료 및 시작의 호출이 방지됩니다.

리턴된 인풋 메서드 윈도우가 필요하지 않게 되었을 경우에 인풋 메서드는 그 인풋 메서드 윈도우로 Window.dispose를 호출할 필요가 있습니다.

파라미터:

title - 타이틀 바가 존재하는 경우, 윈도우의 타이틀 바에 표시되는 타이틀. null값은 비어있는 캐릭터 라인 "" 이라고 보여지는

attachToInputContext - 이 윈도우가 인풋 메서드 컨텍스트에 대응하는 입력 컨텍스트를 공유할지 어떨지

반환값:

인풋 메서드가 사용하는 특성을 보관 유지하는 윈도우

예외:

HeadlessException - GraphicsEnvironment.isHeadless가 true를 돌려주는 경우

createInputMethodJFrame

JFrame  createInputMethodJFrame(String  title,
                               boolean attachToInputContext)

인풋 메서드가 사용하는 톱 레벨의 Swing JFrame를 작성합니다. 이 윈도우의 동작을 다음에 나타냅니다.

• 모든 document window와 다이얼로그 위에 표시한다
• 윈도우와 그 중의 모든 컴퍼넌트는 포커스를 받지 않는다
• 타이틀이 없는 축소 드래그 영역과 같은 경량의 장식을 보관 유지한다

다만, 이러한 3개의 항목에 관한 실제의 동작은 플랫폼에 존하고 있습니다.

타이틀이 표시 또는 비표시가 될까는 작성된 윈도우의 실제의 타입에 의존합니다.

attachToInputContext가 true인 경우, 새로운 윈도우는 이 인풋 메서드 컨텍스트에 대응한 입력 컨텍스트를 공유할 수 있습니다. 이것에 의해 윈도우에 있는 컴퍼넌트의 이벤트는 자동적으로 그 인풋 메서드에 디스패치 됩니다. 게다가 setVisible(true)를 사용해 윈도우를 열고 있을 때는 입력 컨텍스트에 의해 다른 방법에 따르는 인풋 메서드에의 종료 및 시작의 호출이 방지됩니다.

리턴된 인풋 메서드 윈도우가 필요하지 않게 되었을 경우에 인풋 메서드는 그 인풋 메서드 윈도우로 Window.dispose를 호출할 필요가 있습니다.

파라미터:

title - 타이틀 바가 존재하는 경우, 윈도우의 타이틀 바에 표시되는 타이틀. null값은 비어있는 캐릭터 라인 "" 이라고 보여지는

attachToInputContext - 이 윈도우가 인풋 메서드 컨텍스트에 대응하는 입력 컨텍스트를 공유할지 어떨지

반환값:

인풋 메서드가 사용하는 특성을 보관 유지하는 JFrame

예외:

HeadlessException - GraphicsEnvironment.isHeadless가 true를 돌려주는 경우

도입된 버전 :

1.4

enableClientWindowNotification

void enableClientWindowNotification(InputMethod  inputMethod,
                                    boolean enable)

지정된 인풋 메서드에 대한 현재의 클라이언트 윈도우의 위치 및 상태의 통지를 사용 가능 또는 사용 불가능하게 합니다. 통지가 사용 가능한 경우는 인풋 메서드의 notifyClientWindowChange 메서드가 그 메서드의 사양에 기술되고 있는 대로 호출합니다. 인풋 메서드가 파기되면, 통지는 자동적으로 사용 불가능하게 됩니다.

파라미터:

inputMethod - 통지를 사용 가능 또는 사용 불가능하게 하는 인풋 메서드

enable - 사용 가능하게 하려면 true, 사용 불가능하게 하려면 false