java.awt.im
클래스 InputContext

java.lang.Object 
  java.awt.im.InputContext

public class InputContext
extends Object 

인풋 메서드 및 키보드의 배치 등, 텍스트 입력 기능을 제어하는 메서드를 제공합니다. 다음의 2개의 메서드가 인풋 메서드와 키보드의 배치의 양쪽 모두를 처리합니다. selectInputMethod는 클라이언트 컴퍼넌트가 로케일에 의해 인풋 메서드와 키보드의 배치를 선택할 수 있도록 합니다. getLocale는 클라이언트 컴퍼넌트가 현재의 인풋 메서드와 키보드의 배치의 로케일을 취득할 수 있도록 합니다. 그 외의 메서드는 인풋 메서드와의 대화를 보다 구체적으로 지원합니다. 이러한 메서드는 클라이언트 컴퍼넌트가 인풋 메서드의 동작을 제어해, 클라이언트 컴퍼넌트로부터 인풋 메서드에 이벤트를 디스패치 할 수 있도록 합니다.

디폴트에서는 Window 인스턴스 마다 1개의 InputContext 인스턴스가 생성되어 이 입력 컨텍스트은 윈도우의 컨테이너 계층내에 있는 모든 컴퍼넌트에 의해 공유됩니다. 다만, 윈도우내에서는 1회에 1개의 텍스트 입력 오퍼레이션만이 가능하고, 텍스트 컴퍼넌트간에 포커스를 이동할 경우에는 텍스트를 확정할 필요가 있습니다. 이것이 바람직하지 않은 경우, 텍스트 컴퍼넌트는 독자적인 입력 컨텍스트 인스턴스를 생성할 수 있습니다.

Java 2 플랫폼은 Java 프로그램 언어로 개발되어java.awt.im.spi 패키지의 인터페이스를 사용해, 확장 기능으로서 Java 2 실행 환경에 인스톨 되는 인풋 메서드를 지원합니다. 또 구현은 실행하는 플랫폼의 네이티브인 인풋 메서드의 사용을 지원할 수 있습니다. 다만, 모든 플랫폼 및 로케일이 인풋 메서드를 제공하는 것은 아닙니다. 키보드의 배치는 호스트 플랫폼에 의해 제공됩니다.

인풋 메서드는 (a) Java 프로그램 언어로 쓰여진 인풋 메서드가 굳이 인스톨 되지 않고, (b) Java 2 구현 또는 기본이 되는 플랫폼이 네이티브의 인풋 메서드를 지원하고 있지 않는 경우는 「사용할 수 없습니다」. 그 경우에서도, 입력 컨텍스트를 작성해 사용할 수 있습니다. 입력 컨텍스트 의 동작은 아래와 같은 개별 메서드에 의해 지정됩니다.

도입된 버전 :

1.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

생성자 상세

InputContext

protected InputContext()

InputContext를 구축합니다. 이 메서드는 클라이언트가 InputContext 인스턴스를 직접 생성할 수 없게 보호되고 있습니다. 입력 컨텍스트은 getInstance()를 호출해 취득합니다.

메서드의 상세

getInstance

public static InputContext  getInstance()

새로운 InputContext 인스턴스를 리턴합니다.

selectInputMethod

public boolean selectInputMethod(Locale  locale)

지정된 로케일을 지원하는 인풋 메서드 또는 키보드의 배치를 선택하려고 할 때, 인풋 메서드 또는 키보드의 배값이 정상적으로 선택되었는지 어떠했는지를 나타내는 값을 리턴합니다. 인풋 메서드가 선택될 때까지는 다음의 순서에 따릅니다.

• 현재 선택되고 있는 인풋 메서드 또는 키보드의 배값이 요구된 로케일을 지원하는 경우, 선택된 상태대로 합니다.
• 요구된 로케일을 지원하는 인풋 메서드 또는 키보드의 배치를 사용할 수 없는 경우, 현재의 인풋 메서드 또는 키보드의 배치를 그대로 선택합니다.
• 이전에 사용자가 요구된 로케일에 대한 인풋 메서드 또는 키보드의 배치를 사용자 인터페이스로부터 선택했을 경우, 직전에 선택한 인풋 메서드 또는 키보드의 배값이 한번 더 선택됩니다.
• 그 외의 경우는 요구된 로케일을 지원하는 인풋 메서드 또는 키보드의 배값이 구현 마다 다른 방법으로 선택됩니다.

인풋 메서드를 바꾸기 전에 현재 미확정의 텍스트가 확정됩니다. 요구된 로케일을 지원하는 인풋 메서드 또는 키보드의 배치를 사용할 수 없는 경우, false가 리턴됩니다 .

모든 호스트 OS가 현재 선택되고 있는 네이티브의 인풋 메서드 또는 키보드의 배치의 로케일을 판정하거나 로케일에 의해 네이티브의 인풋 메서드 또는 키보드의 배치를 선택하는 API를 제공하고 있는 것은 아닙니다. 이러한 API를 제공하지 않는 호스트 OS 의 경우, selectInputMethod 은 호스트 OS가 제공하는 네이티브의 인풋 메서드 또는 키보드의 배값이 시스템의 디폴트 로케일만을 지원하는 것이라고 봅니다.

예를 들어 사용자가 삽입 포인트를 변경하는 경우, 텍스트 편집 컴퍼넌트로부터 이 메서드를 호출하는 것으로 사용자가 삽입 포인트 전후의 텍스트의 언어로 즉시 입력을 속행할 수 있습니다.

파라미터:

locale - 목적의 새로운 로케일

반환값:

이 호출의 나중에 활성화 되는 인풋 메서드 또는 키보드의 배값이 목적의 로케일을 지원하는 경우는 true

예외:

NullPointerException - locale가 null인 경우

getLocale

public Locale  getLocale()

현재의 인풋 메서드 또는 키보드 배치의 현재의 로케일을 리턴합니다. 입력 컨텍스트이 현재의 인풋 메서드 또는 키보드 배치를 보관 유지하지 않는 경우, 또는 현재의 인풋 메서드의 InputMethod.getLocale() 메서드가 null을 돌려주는 경우, null이 리턴됩니다 .

모든 호스트 OS가 현재 선택되고 있는 네이티브의 인풋 메서드 또는 키보드 배치의 로케일을 판정하는 API를 제공하고 있는 것은 아닙니다. 이러한 API를 제공하지 않는 호스트 OS 의 경우, getLocale는 호스트 OS가 제공하는 모든 네이티브인 인풋 메서드 또는 키보드 배치의 현재의 로케일을 시스템의 디폴트 로케일이라고 봅니다.

반환값:

현재의 인풋 메서드 또는 키보드 배치의 현재의 로케일

도입된 버전 :

1.3

setCharacterSubsets

public void setCharacterSubsets(Character.Subset [] subsets)

이 입력 컨텍스트 의 인풋 메서드로 입력할 수 있는 Unicode 캐릭터셋의 부분집합을 설정합니다. null을 건네주면, 모든 문자를 사용할 수 있습니다. 초기값 는 null 입니다. 이 설정은 현재의 인풋 메서드와 이 호출을 한 후에 선택되는 인풋 메서드에 적용됩니다. 다만, 이 설정을 모든 호스트 인풋 메서드에 건네주는 것이 가능한 것은 아니기 때문에 이 호출만으로는 목적의 결과를 얻을 수 없는 경우도 있습니다. 그 때문에 어플리케이션이 자신으로 문자를 확인할 필요는 남습니다. 사용할 수 있는 인풋 메서드가 없는 경우, 이 메서드는 무효입니다.

파라미터:

subsets - 문자 입력에 사용할 수 있는 Unicode 캐릭터셋의 부분집합

setCompositionEnabled

public void setCompositionEnabled(boolean enable)

파라미터 enable값에 응해, 변환을 위해서 현재의 인풋 메서드를 사용 가능 또는 불가능하게 합니다.

변환을 위해서 사용 가능한 인풋 메서드는 변환과 제어의 2개의 목적으로 들어 오는 이벤트를 해석합니다. 한편, 사용 불가능한 인풋 메서드는 변환을 위해서 이벤트를 해석하지 않습니다. 다만, 인풋 메서드가 사용 가능한가 어떤가에 관계없이, 이벤트는 인풋 메서드에게 건네집니다. 또, 변환에 사용 불가능한 인풋 메서드여도, 변환을 위해서 자신을 사용 가능 또는 사용 불가능하게 하는 등의 제어 목적으로 이벤트를 해석할 수 있습니다 .

호스트 OS에 의해 제공되는 인풋 메서드의 경우, 이 조작이 지원되고 있는지를 항상 판단할 수 있다고는 할 수 없습니다. 예를 들어 인풋 메서드가 특정의 로케일로 밖에 변환하지 못하고, 다른 로케일에 대해서는 아무것도 실시하지 않는 경우가 있습니다. 그러한 인풋 메서드의 경우, 이 메서드가 UnsupportedOperationException를 Throw 하지 않을 가능성이 있습니다만, 변환이 가능한지 어떤지에 영향을 주는 일도 없습니다.

파라미터:

enable - 현재의 인풋 메서드를 변환을 위해서 사용 가능하게 할지 어떨지

예외:

UnsupportedOperationException - 현재 사용할 수 있는 인풋 메서드가 없는지, 혹은 현재의 인풋 메서드가 사용 가능과 불가능의 조작을 지원하고 있지 않는 경우

도입된 버전 :

1.3

관련 항목:

isCompositionEnabled()

isCompositionEnabled

public boolean isCompositionEnabled()

현재의 인풋 메서드가 변환을 위해서 사용 가능한가 어떤가 판별합니다. 변환 위해 사용할 수 있는 인풋 메서드는 변환 목적과 제어 목적의 양쪽 모두의 수신 이벤트를 해석합니다. 사용 불가능한 인풋 메서드는 변환을 위해서 이벤트를 해석하지 않습니다.

반환값:

현재의 인풋 메서드가 변환을 위해서 사용 가능한 경우는 true, 그렇지 않은 경우는 false

예외:

UnsupportedOperationException - 현재 사용할 수 있는 인풋 메서드가 없는지, 혹은 현재의 인풋 메서드가 변환을 위해서 사용 가능한가 어떤가의 확인을 지원하고 있지 않는 경우

도입된 버전 :

1.3

관련 항목:

setCompositionEnabled(boolean)

reconvert

public void reconvert()

현재의 인풋 메서드에 대해, 현재의 클라이언트 컴퍼넌트로부터의 텍스트의 재변환을 요구합니다. 인풋 메서드는 InputMethodRequests.getSelectedText 메서드를 사용해, 재변환하는 텍스트를 클라이언트 컴퍼넌트로부터 취득합니다. 인풋 메서드에 한 상세 정보의 요구를 처리하기 위해서 다른 InputMethodRequests 메서드를 준비해 둘 필요가 있습니다. 변환된 텍스트 또는 확정 텍스트, 혹은 그 양쪽 모두가InputMethodEvent 처리로서 클라이언트 컴퍼넌트에 보내집니다. 지정된 텍스트를 인풋 메서드가 재변환할 수 없는 경우, 그 텍스트가 InputMethodEvent 확정 텍스트로서 리턴됩니다 .

예외:

UnsupportedOperationException - 현재 사용할 수 있는 인풋 메서드가 없는지, 혹은 현재의 인풋 메서드가 변환 조작을 지원하고 있지 않는 경우

도입된 버전 :

1.3

dispatchEvent

public void dispatchEvent(AWTEvent  event)

활성화된 인풋 메서드에 이벤트를 디스패치 합니다. AWT에 의해 호출합니다. 사용할 수 있는 인풋 메서드가 없는 경우, 이벤트는 처리되지 않습니다.

파라미터:

event - 이벤트

예외:

NullPointerException - event이 null인 경우

removeNotify

public void removeNotify(Component  client)

포함 관계의 계층으로부터 클라이언트 컴퍼넌트가 삭제되었는지, 또는 컴퍼넌트로 인풋 메서드가 지원되지 않게 된 것을 입력 컨텍스트에 통지합니다. 이 메서드는 보통, 클라이언트 컴퍼넌트의 Component.removeNotify 메서드로부터 호출합니다. 이 컴퍼넌트에 대한 인풋 메서드로부터의 입력이 보류중의 경우, 그 입력은 파기됩니다. 사용할 수 있는 인풋 메서드가 없는 경우, 이 메서드는 무효입니다.

파라미터:

client - 클라이언트 컴퍼넌트

예외:

NullPointerException - client이 null인 경우

endComposition

public void endComposition()

이 컨텍스트 으로 현재 진행중의 입력 변환을 종료합니다. 플랫폼 및 사용자 설정에 응해, 미확정의 텍스트를 확정 또는 삭제합니다. 텍스트에 대한 변경은 인풋 메서드 이벤트를 사용해 활성화된 컴퍼넌트에 통지됩니다. 사용할 수 있는 인풋 메서드가 없는 경우, 이 메서드는 무효입니다.

텍스트 편집 컴퍼넌트는 예를 들어 사용자가 텍스트내에서 (변환 텍스트의 외부에) 삽입 포인트를 이동했을 때나, 컴퍼넌트의 텍스트가 파일에 보존되거나 클립보드에 카피되었을 때 등, 다양한 상황으로 이 메서드를 호출하는 일이 있습니다.

dispose

public void dispose()

입력 컨텍스트를 파기해, 입력 컨텍스트이 사용하고 있는 자원을 해방합니다. 호출은 각 Window 디폴트 입력 컨텍스트 의 AWT에 의해 행해집니다. 사용할 수 있는 인풋 메서드가 없는 경우, 이 메서드는 무효입니다.

getInputMethodControlObject

public Object  getInputMethodControlObject()

현재의 인풋 메서드의 제어 객체 또는 null을 리턴합니다. 제어 객체는 인풋 메서드의 동작을 제어하는 메서드나, 인풋 메서드로부터 정보를 얻는 메서드를 제공합니다. 객체의 형태는 인풋 메서드 고유의 클래스입니다. 클라이언트는 기존의 인풋 메서드 제어 객체 클래스와 결과를 비교해, 제공되는 메서드를 호출하기 위해서 적절한 클래스에 캐스트 할 필요가 있습니다.

사용할 수 있는 인풋 메서드가 없는지, 혹은 현재의 인풋 메서드가 인풋 메서드 제어 객체를 제공하고 있지 않는 경우, null이 리턴됩니다 .

반환값:

현재의 인풋 메서드의 제어 객체, 또는 null