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 치는 빈 상태(empty)의 캐릭터 라인 "" 으로서 다루어지는

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 치는 빈 상태(empty)의 캐릭터 라인 "" 으로서 다루어지는

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

반환값:

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

예외:

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

도입된 버젼:

1.4

enableClientWindowNotification

void enableClientWindowNotification(InputMethod  inputMethod,
                                    boolean enable)

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

파라미터:

inputMethod - 통지를 사용 가능 또는 사용 불가능하게 한다 입력 메소드

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