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

public 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

public Window  createInputMethodWindow(String  title,
                                      boolean attachToInputContext)

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

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

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

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

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

파라미터:

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

attachToInputContext - 이 윈도우가, 인풋 메소드 문맥에 대응하는 입력 문맥을 공유할지 어떨지

반환값:

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

예외:

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

createInputMethodJFrame

public JFrame  createInputMethodJFrame(String  title,
                                      boolean attachToInputContext)

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

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

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

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

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

파라미터:

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

attachToInputContext - 이 윈도우가, 인풋 메소드 문맥에 대응하는 입력 문맥을 공유할지 어떨지

반환값:

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

예외:

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

도입된 버젼:

1.4

enableClientWindowNotification

public void enableClientWindowNotification(InputMethod  inputMethod,
                                           boolean enable)

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

파라미터:

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

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