java.awt.im.spi

Интерфейс InputMethodDescriptor

public interface InputMethodDescriptor

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

С тех пор:

1.3

Сводка метода

Модификатор и Тип	Метод и Описание
InputMethod	createInputMethod() Создает новый экземпляр соответствующего входного метода.
Локаль[]	getAvailableLocales() Возвращает локали, поддерживаемые соответствующим входным методом.
Строка	getInputMethodDisplayName(Locale inputLocale, Locale displayLanguage) Возвращает видимое пользователем имя соответствующего входного метода для данной входной локали на языке, на котором будет выведено на экран имя.
Изображение	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 Exception

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

Возвраты:

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

Броски:

Exception - любое исключение, которое может произойти, создавая входной экземпляр метода