Spec-Zone.ru › OpenJDK 17

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

Spec-Zone.ru

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