Интерфейс InputMethodDescriptor
public interface InputMethodDescriptor
- Since:
- 1.3
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
InputMethod |
createInputMethod() |
Создаёт новый экземпляр соответствующего метода ввода. |
Locale[] |
getAvailableLocales() |
Возвращает языковые варианты, поддерживаемые соответствующим методом ввода. |
String |
getInputMethodDisplayName |
Возвращает видимое пользователю имя соответствующего метода ввода для заданного языка ввода на языке, на котором будет отображено имя. |
Image |
getInputMethodIcon |
Возвращает значок для соответствующего метода ввода. |
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