java.awt.im.InputContext
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 전의 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
java.lang.Object
public class InputContext
인풋 메서드 및 키보드의 배치 등, 텍스트 입력 기능을 제어하는 메서드를 제공합니다. 다음의 2개의 메서드가 인풋 메서드와 키보드의 배치의 양쪽 모두를 처리합니다. selectInputMethod는 클라이언트 컴퍼넌트가 로케일에 의해 인풋 메서드와 키보드의 배치를 선택할 수 있도록 합니다. getLocale는 클라이언트 컴퍼넌트가 현재의 인풋 메서드와 키보드의 배치의 로케일을 취득할 수 있도록 합니다. 그 외의 메서드는 인풋 메서드와의 대화를 보다 구체적으로 지원합니다. 이러한 메서드는 클라이언트 컴퍼넌트가 인풋 메서드의 동작을 제어해, 클라이언트 컴퍼넌트로부터 인풋 메서드에 이벤트를 디스패치 할 수 있도록 합니다.
디폴트에서는 Window 인스턴스 마다 1개의 InputContext 인스턴스가 생성되어 이 입력 컨텍스트은 윈도우의 컨테이너 계층내에 있는 모든 컴퍼넌트에 의해 공유됩니다. 다만, 윈도우내에서는 1회에 1개의 텍스트 입력 오퍼레이션만이 가능하고, 텍스트 컴퍼넌트간에 포커스를 이동할 경우에는 텍스트를 확정할 필요가 있습니다. 이것이 바람직하지 않은 경우, 텍스트 컴퍼넌트는 독자적인 입력 컨텍스트 인스턴스를 생성할 수 있습니다.
Java 2 플랫폼은 Java 프로그램 언어로 개발되어java.awt.im.spi 패키지의 인터페이스를 사용해, 확장 기능으로서 Java 2 실행 환경에 인스톨 되는 인풋 메서드를 지원합니다. 또 구현은 실행하는 플랫폼의 네이티브인 인풋 메서드의 사용을 지원할 수 있습니다. 다만, 모든 플랫폼 및 로케일이 인풋 메서드를 제공하는 것은 아닙니다. 키보드의 배치는 호스트 플랫폼에 의해 제공됩니다.
인풋 메서드는 (a) Java 프로그램 언어로 쓰여진 인풋 메서드가 굳이 인스톨 되지 않고, (b) Java 2 구현 또는 기본이 되는 플랫폼이 네이티브의 인풋 메서드를 지원하고 있지 않는 경우는 「사용할 수 없습니다」. 그 경우에서도, 입력 컨텍스트를 작성해 사용할 수 있습니다. 입력 컨텍스트 의 동작은 아래와 같은 개별 메서드에 의해 지정됩니다.
Component.getInputContext(),
Component.enableInputMethods(boolean) | 생성자 개요 | |
|---|---|
protected |
InputContext ()
InputContext를 구축합니다. |
| 메서드 개요 | |
|---|---|
void |
dispatchEvent (AWTEvent event)
활성화된 인풋 메서드에 이벤트를 디스패치 합니다. |
void |
dispose ()
입력 컨텍스트를 파기해, 입력 컨텍스트이 사용하고 있는 자원을 해방합니다. |
void |
endComposition ()
이 컨텍스트 으로 현재 진행중의 입력 변환을 종료합니다. |
Object |
getInputMethodControlObject ()
현재의 인풋 메서드의 제어 객체 또는 null을 리턴합니다. |
static InputContext |
getInstance ()
새로운 InputContext 인스턴스를 리턴합니다. |
Locale |
getLocale ()
현재의 인풋 메서드 또는 키보드 배치의 현재의 로케일을 리턴합니다. |
boolean |
isCompositionEnabled ()
현재의 인풋 메서드가 변환을 위해서 사용 가능한가 어떤가 판별합니다. |
void |
reconvert ()
현재의 인풋 메서드에 대해, 현재의 클라이언트 컴퍼넌트로부터의 텍스트의 재변환을 요구합니다. |
void |
removeNotify (Component client)
포함 관계의 계층으로부터 클라이언트 컴퍼넌트가 삭제되었는지, 또는 컴퍼넌트로 인풋 메서드가 지원되지 않게 된 것을 입력 컨텍스트에 통지합니다. |
boolean |
selectInputMethod (Locale locale)
지정된 로케일을 지원하는 인풋 메서드 또는 키보드의 배치를 선택하려고 할 때, 인풋 메서드 또는 키보드의 배값이 정상적으로 선택되었는지 어떠했는지를 나타내는 값을 리턴합니다. |
void |
setCharacterSubsets (Character.Subset [] subsets)
이 입력 컨텍스트 의 인풋 메서드로 입력할 수 있는 Unicode 캐릭터셋의 부분집합을 설정합니다. |
void |
setCompositionEnabled (boolean enable)
파라미터 enable값에 응해, 변환을 위해서 현재의 인풋 메서드를 사용 가능 또는 불가능하게 합니다. |
| 클래스 java.lang. Object 로부터 상속된 메서드 |
|---|
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
| 생성자 상세 |
|---|
protected InputContext()
getInstance()를
호출해 취득합니다.
| 메서드의 상세 |
|---|
public static InputContext getInstance()
public boolean selectInputMethod(Locale locale)
모든 호스트 OS가 현재 선택되고 있는 네이티브의 인풋 메서드 또는 키보드의 배치의 로케일을 판정하거나 로케일에 의해 네이티브의 인풋 메서드 또는 키보드의 배치를 선택하는 API를 제공하고 있는 것은 아닙니다. 이러한 API를 제공하지 않는 호스트 OS
의 경우, selectInputMethod 은 호스트 OS가 제공하는 네이티브의 인풋 메서드 또는 키보드의 배값이 시스템의 디폴트 로케일만을 지원하는 것이라고 봅니다.
예를 들어 사용자가 삽입 포인트를 변경하는 경우, 텍스트 편집 컴퍼넌트로부터 이 메서드를 호출하는 것으로 사용자가 삽입 포인트 전후의 텍스트의 언어로 즉시 입력을 속행할 수 있습니다.
locale - 목적의 새로운 로케일
NullPointerException - locale가 null인 경우public Locale getLocale()
InputMethod.getLocale() 메서드가 null을
돌려주는 경우, null이 리턴됩니다
.
모든 호스트 OS가 현재 선택되고 있는 네이티브의 인풋 메서드 또는 키보드 배치의 로케일을 판정하는 API를 제공하고 있는 것은 아닙니다. 이러한 API를 제공하지 않는 호스트 OS
의 경우, getLocale는
호스트 OS가 제공하는 모든 네이티브인 인풋 메서드 또는 키보드 배치의 현재의 로케일을 시스템의 디폴트 로케일이라고 봅니다.
public void setCharacterSubsets(Character.Subset [] subsets)
subsets - 문자 입력에 사용할 수 있는 Unicode 캐릭터셋의 부분집합public void setCompositionEnabled(boolean enable)
enable값에 응해, 변환을 위해서 현재의 인풋 메서드를 사용 가능 또는 불가능하게 합니다.
변환을 위해서 사용 가능한 인풋 메서드는 변환과 제어의 2개의 목적으로 들어 오는 이벤트를 해석합니다. 한편, 사용 불가능한 인풋 메서드는 변환을 위해서 이벤트를 해석하지 않습니다. 다만, 인풋 메서드가 사용 가능한가 어떤가에 관계없이, 이벤트는 인풋 메서드에게 건네집니다. 또, 변환에 사용 불가능한 인풋 메서드여도, 변환을 위해서 자신을 사용 가능 또는 사용 불가능하게 하는 등의 제어 목적으로 이벤트를 해석할 수 있습니다 .
호스트 OS에 의해 제공되는 인풋 메서드의 경우, 이 조작이 지원되고 있는지를 항상 판단할 수 있다고는 할 수 없습니다. 예를 들어
인풋 메서드가 특정의 로케일로 밖에 변환하지 못하고, 다른 로케일에 대해서는 아무것도 실시하지 않는 경우가 있습니다. 그러한 인풋 메서드의 경우, 이 메서드가 UnsupportedOperationException를
Throw 하지 않을 가능성이 있습니다만, 변환이 가능한지 어떤지에 영향을 주는 일도 없습니다.
enable - 현재의 인풋 메서드를 변환을 위해서 사용 가능하게 할지 어떨지
UnsupportedOperationException - 현재 사용할 수 있는 인풋 메서드가 없는지, 혹은 현재의 인풋 메서드가 사용 가능과 불가능의 조작을 지원하고 있지 않는 경우isCompositionEnabled() public boolean isCompositionEnabled()
true, 그렇지 않은 경우는 false
UnsupportedOperationException - 현재 사용할 수 있는 인풋 메서드가 없는지, 혹은 현재의 인풋 메서드가 변환을 위해서 사용 가능한가 어떤가의 확인을 지원하고 있지 않는 경우setCompositionEnabled(boolean) public void reconvert()
InputMethodRequests.getSelectedText 메서드를 사용해, 재변환하는 텍스트를 클라이언트 컴퍼넌트로부터 취득합니다. 인풋 메서드에
한 상세 정보의 요구를 처리하기 위해서
다른 InputMethodRequests 메서드를 준비해 둘 필요가 있습니다. 변환된 텍스트 또는 확정 텍스트, 혹은 그 양쪽 모두가InputMethodEvent
처리로서 클라이언트 컴퍼넌트에 보내집니다. 지정된 텍스트를 인풋 메서드가 재변환할 수 없는 경우, 그 텍스트가 InputMethodEvent
확정 텍스트로서 리턴됩니다
.
UnsupportedOperationException - 현재 사용할 수 있는 인풋 메서드가 없는지, 혹은 현재의 인풋 메서드가 변환 조작을 지원하고 있지 않는 경우public void dispatchEvent(AWTEvent event)
event - 이벤트
NullPointerException - event이 null인 경우public void removeNotify(Component client)
Component.removeNotify 메서드로부터 호출합니다. 이 컴퍼넌트에 대한 인풋 메서드로부터의 입력이 보류중의 경우, 그 입력은 파기됩니다. 사용할 수 있는 인풋 메서드가 없는 경우, 이 메서드는 무효입니다.
client - 클라이언트 컴퍼넌트
NullPointerException - client이 null인 경우public void endComposition()
텍스트 편집 컴퍼넌트는 예를 들어 사용자가 텍스트내에서 (변환 텍스트의 외부에) 삽입 포인트를 이동했을 때나, 컴퍼넌트의 텍스트가 파일에 보존되거나 클립보드에 카피되었을 때 등, 다양한 상황으로 이 메서드를 호출하는 일이 있습니다.
public void dispose()
public Object getInputMethodControlObject()
사용할 수 있는 인풋 메서드가 없는지, 혹은 현재의 인풋 메서드가 인풋 메서드 제어 객체를 제공하고 있지 않는 경우, null이 리턴됩니다 .
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 전의 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조하십시오.