java.awt.im.spi

Interface InputMethodDescriptor

public interface InputMethodDescriptor

定义提供有关输入方法的足够信息，以使该输入法的选择和加载的方法。输入法本身只加载当它实际上是使用。

从以下版本开始：

一点三

方法摘要

Modifier and Type	Method and Description
InputMethod	createInputMethod() 创建相应的输入法的一个新实例。
Locale[]	getAvailableLocales() 返回由相应的输入法支持的区域设置。
String	getInputMethodDisplayName(Locale inputLocale, Locale displayLanguage) 返回在该名称将显示的语言中给定的输入区域设置的相应输入法的用户可见名称。
Image	getInputMethodIcon(Locale inputLocale) 返回相应的输入法的图标。
boolean	hasDynamicLocaleList() 返回是否可用语言列表可以在运行时改变。

方法详细信息

getAvailableLocales

Locale[] getAvailableLocales()
                      throws AWTException

返回由相应的输入法支持的区域设置。语言设置可以描述语言，也可以包括国家和不同的信息，如果需要的话。信息是用来选择输入法区域设置（ InputContext.selectInputMethod(Locale)）。它也可以用于在输入方法的用户可见列表中的区域设置对输入方法进行排序。

只有输入法的主要场所应退还。例如，如果一个日本的输入法也有一个通过模式为罗马字符，通常仍然只有日本将返回。因此，返回的地点列表通常是一个子集的场所，InputMethod.setLocale(java.util.Locale)相应输入法的实现返回true。

如果hasDynamicLocaleList()返回true，这种方法被称为每一次所需的信息。这给输入方法依赖于网络资源的机会来添加或删除场所资源可用或不可用。

结果

通过输入法支持的区域设置

异常

AWTException -如果可以确定，输入法是无法使用的，例如，由于不完全安装。

hasDynamicLocaleList

boolean hasDynamicLocaleList()

返回是否可用语言列表可以在运行时改变。这可能是这样的情况下，例如，用于访问网络上的实际输入方法的适配器。

getInputMethodDisplayName

String getInputMethodDisplayName(Locale inputLocale,
                                 Locale displayLanguage)

返回在该名称将显示的语言中给定的输入区域设置的相应输入法的用户可见名称。

的inputlocale参数指定区域设置为文本输入。这个参数只能从这个描述符的getAvailableLocales()法或空值。如果它为空，则返回输入法的输入区域设置独立的名称。

如果所需的显示语言的名称不可用，则该方法可能会返回到其他语言。

参数

inputLocale -区域设置为文本输入支持，或空

displayLanguage -语言中的名称将显示

getInputMethodIcon

Image getInputMethodIcon(Locale inputLocale)

返回相应的输入法的图标。该图标可以由用户界面用于选择输入方法。

的inputlocale参数指定区域设置为文本输入。这个参数只能从这个描述符的getAvailableLocales()法或空值。如果它为空，则应返回输入法的输入区域设置独立的图标。

该图标的大小应为16像素16像素。

参数

inputLocale -区域设置为文本输入支持，或空

结果

一个相应的输入法的图标，或

createInputMethod

InputMethod createInputMethod()
                       throws 异常

创建相应的输入法的一个新实例。

结果

相应的输入法的一个新实例

异常

异常 -可能在创建输入法实例发生任何异常