Интерфейс 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(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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/im/spi/InputMethodDescriptor.html