模块 java.desktop
包 java.awt.im.spi

接口 InputMethodDescriptor

public interface InputMethodDescriptor
定义提供有关输入方法的足够信息以启用该输入方法的选择和加载的方法。输入方法本身只有在实际使用时才会加载。
自从：
1.3

  • 方法详情

    • getAvailableLocales

      Locale [] getAvailableLocales() throws AWTException
      返回相应输入法支持的locale。locale可以只描述语言，或者如果需要也可以包括国家和变体信息。该信息用于按locale选择输入法 (InputContext.selectInputMethod(Locale) )。它还可用于在用户可见的输入法列表中按区域设置对输入法进行排序。

      只应返回输入法的主要locale。例如，如果日文输入法也有罗马字符的直通模式，通常仍只会返回日文。因此，返回的locale列表通常是相应输入法的 InputMethod.setLocale(java.util.Locale) 实现返回 true 的locale的子集。

      如果 hasDynamicLocaleList() 返回 true，则每次需要信息时都会调用此方法。这为依赖于网络资源的输入法提供了在资源可用或不可用时添加或删除locale的机会。

      返回：
      输入方法支持的locale
      抛出：
      AWTException - 如果可以确定输入法无法运行，例如，由于安装不完整。

    • hasDynamicLocaleList

      boolean hasDynamicLocaleList()
      返回可用locale列表是否可以在运行时更改。例如，对于通过网络访问真实输入方法的适配器来说可能就是这种情况。
      返回：
      可用locale列表是否可以在运行时更改

    • getInputMethodDisplayName

      String  getInputMethodDisplayName(Locale  inputLocale, Locale  displayLanguage)
      以显示名称的语言返回给定输入区域设置的相应输入方法的用户可见名称。

      inputLocale 参数指定输入文本的区域设置。此参数只能取从此描述符的getAvailableLocales() 方法中获得的值或为空。如果为空，则应返回输入法的输入locale独立名称。

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

      参数：
      inputLocale - 支持文本输入的locale，或者为 null
      displayLanguage - 显示名称的语言
      返回：
      给定输入区域设置的相应输入方法的用户可见名称，以显示名称的语言显示

    • getInputMethodIcon

      Image  getInputMethodIcon(Locale  inputLocale)
      返回相应输入方法的图标。用户界面可以使用该图标来选择输入方法。

      inputLocale 参数指定输入文本的区域设置。此参数只能取从此描述符的getAvailableLocales() 方法中获得的值或为空。如果为空，则应返回输入法的输入locale独立图标。

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

      参数：
      inputLocale - 支持文本输入的locale，或者为 null
      返回：
      相应输入方法的图标，或 null

    • createInputMethod

      InputMethod  createInputMethod() throws Exception
      创建相应输入方法的新实例。
      返回：
      相应输入方法的新实例
      抛出：
      Exception - 创建输入法实例时可能发生的任何异常