public interface InputMethodDescriptor
定义提供足够的关于输入方法启用选择和该输入方法加载信息的方法。输入方法只有在实际使用时才加载其自身。
方法摘要 | |
---|---|
InputMethod |
createInputMethod() 创建相应输入方法的新实例。 |
Locale[] |
getAvailableLocales() 返回相应输入方法支持的语言环境。 |
String |
getInputMethodDisplayName(Locale inputLocale, Locale displayLanguage) 用将显示该名称的语言返回用户可视名称,该名称与给定的输入语言环境的输入方法相对应。 |
Image |
getInputMethodIcon(Locale inputLocale) 返回相应输入方法的图标。 |
boolean |
hasDynamicLocaleList() 返回可用语言环境列表是否可在运行时更改。 |
方法详细信息 |
---|
Locale[] getAvailableLocales() throws AWTException
InputContext.selectInputMethod(Locale)
)。还可以按用户可视输入方法列表的语言环境将它用于输入方法排序。
只应返回输入方法的主要语言环境。例如,如果日语输入方法也有通向罗马字符的模式,通常仍只返回日语。因此,已返回的语言环境列表通常是相应输入方法的 InputMethod.setLocale(java.util.Locale)
实现返回 true 的语言环境的子集。
如果 hasDynamicLocaleList()
返回 true,则每次需要信息时就调用此方法。这就在资源变得可用或不可用时给依赖于网络资源的输入方法提供了添加或移除语言环境的机会。
AWTException
- 如果能够确定输入方法不可操作(例如,由于安装不完整)。
boolean hasDynamicLocaleList()
String getInputMethodDisplayName(Locale inputLocale, Locale displayLanguage)
inputLocale 参数指定文本输入的语言环境。此参数只可以采取通过此描述符的 getAvailableLocales()
方法获得的值或 null。如果为 null,将返回该输入方法的某个独立于输入语言环境的名称。
如果所需显示语言的名称不可用,该方法可能会转回到其他某种语言。
inputLocale
- 支持文本输入的语言环境,或 null
displayLanguage
- 显示名称的语言
Image getInputMethodIcon(Locale inputLocale)
inputLocale 参数指定文本输入的语言环境。此参数只可以采取通过此描述符的 getAvailableLocales()
方法获得的值或 null。如果为 null,将返回该输入方法的某个独立于输入语言环境的图标。
图标的大小应是 16×16 像素。
inputLocale
- 支持文本输入的语言环境,或 null
InputMethod createInputMethod() throws Exception
Exception
- 可能在创建输入方法实例时发生的任何异常