Интерфейс InputMethodDescriptor

public interface InputMethodDescriptor

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

Since:: 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, 2025, 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/im/spi/InputMethodDescriptor.html