Интерфейс InputMethodDescriptor

public interface InputMethodDescriptor

Определяет методы, предоставляющие достаточную информацию об методе ввода, позволяющую выбрать и загрузить этот метод ввода. Сам метод ввода загружается только при его фактическом использовании.

С момента:: 1.3

Методы

Модификатор и тип	Метод и описание
`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() данного описателя или null. Если он равен null, должен возвращаться независимый от локали ввода имя метода ввода.

Если имя для желаемого языка отображения недоступно, метод может перейти к другому языку.

Параметры:: inputLocale - локаль, для которой поддерживается ввод текста, или null; displayLanguage - язык, на котором будет отображено имя

getInputMethodIcon

Image getInputMethodIcon(Locale inputLocale)

Возвращает значок соответствующего метода ввода. Значок может использоваться пользовательским интерфейсом для выбора методов ввода.

Параметр inputLocale определяет локаль, для которой вводится текст. Этот параметр может принимать только значения, полученные из метода getAvailableLocales() данного описателя или null. Если он равен null, должен возвращаться значок метода ввода, независимый от локали ввода.

Размер значка должен составлять 16×16 пикселей.

Параметры:: inputLocale - локаль, для которой поддерживается ввод текста, или null
Возвращает:: значок соответствующего метода ввода или null

createInputMethod

InputMethod createInputMethod()
                       throws Exception

Создаёт новый экземпляр соответствующего метода ввода.

Возвращает:: новый экземпляр соответствующего метода ввода
Извонит:: Exception - любое исключение, которое может возникнуть при создании экземпляра метода ввода

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.