Spec-Zone.ru › OpenJDK 21

Интерфейс 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, 2023, 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/21/docs/api/java.desktop/java/awt/im/spi/InputMethodDescriptor.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API