Интерфейс InputMethodContext

Все суперинтерфейсы:: InputMethodRequests

public interface InputMethodContext extends InputMethodRequests

Предоставляет методы, которые могут использовать методы ввода для взаимодействия со своими клиентскими компонентами или для запроса других сервисов. Этот интерфейс реализуется фреймворком методов ввода, и методы ввода вызывают его методы на экземпляре, который они получают через InputMethod.setInputMethodContext(java.awt.im.spi.InputMethodContext). Не должно быть других реализаторов или вызывающих сторон.

С:: 1.3

Краткое описание методов

Модификатор и тип	Метод	Описание
`JFrame`	`createInputMethodJFrame(String title, boolean attachToInputContext)`	Создает окно Swing JFrame верхнего уровня для использования методом ввода.
`Window`	`createInputMethodWindow(String title, boolean attachToInputContext)`	Создает окно верхнего уровня для использования методом ввода.
`void`	`dispatchInputMethodEvent(int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition)`	Создает событие метода ввода из заданных аргументов и отправляет его клиентскому компоненту.
`void`	`enableClientWindowNotification(InputMethod inputMethod, boolean enable)`	Включает или отключает уведомление о местоположении и состоянии текущего клиентского окна для указанного метода ввода.

Методы, объявленные в интерфейсе java.awt.im.InputMethodRequests

cancelLatestCommittedText, getCommittedText, getCommittedTextLength, getInsertPositionOffset, getLocationOffset, getSelectedText, getTextLocation

Подробное описание методов

dispatchInputMethodEvent

void dispatchInputMethodEvent(int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition)

Создает событие метода ввода из заданных аргументов и отправляет его клиентскому компоненту. Для аргументов см. InputMethodEvent(java.awt.Component, int, java.awt.font.TextHitInfo, java.awt.font.TextHitInfo).

Параметры:: id - тип события; text - объединенный текст подтверждения и составления; committedCharacterCount - количество символов подтверждения в тексте; caret - курсор (также известен как точка вставки); null, если в текущем составленном тексте нет курсора; visiblePosition - позиция, которая наиболее важна для отображения; null, если нет рекомендации по отображению позиции в текущем составленном тексте

createInputMethodWindow

Window createInputMethodWindow(String title, boolean attachToInputContext)

Создает окно верхнего уровня для использования методом ввода. Ожидаемое поведение этого окна:

оно расположено поверх всех окон документов и диалогов
оно и все компоненты, которые оно содержит, не получают фокус
оно имеет легкие украшения, такие как уменьшенная область перетаскивания без заголовка

Однако фактическое поведение по этим трем пунктам зависит от платформы.

Заголовок может отображаться или нет, в зависимости от фактического типа созданного окна.

Если attachToInputContext равен true, новое окно будет совместно использовать контекст ввода, соответствующий этому контексту метода ввода, так что события для компонентов в окне автоматически отправляются методу ввода. Кроме того, когда окно открывается с помощью setVisible(true), контекст ввода предотвратит вызовы deactivate и activate методу ввода, которые могли бы быть вызваны в противном случае.

Методы ввода должны вызвать Window.dispose на возвращенном окне метода ввода, когда оно больше не требуется.

Параметры:: title - заголовок, который должен отображаться в строке заголовка окна, если такая строка заголовка есть. Значение null обрабатывается как пустая строка, "".; attachToInputContext - нужно ли этому окну совместно использовать контекст ввода, соответствующий этому контексту метода ввода
Возвращает:: окно со специальными характеристиками для использования методами ввода
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true

createInputMethodJFrame

JFrame createInputMethodJFrame(String title, boolean attachToInputContext)

Создает окно Swing JFrame верхнего уровня для использования методом ввода. Ожидаемое поведение этого окна:

оно расположено поверх всех окон документов и диалогов
оно и все компоненты, которые оно содержит, не получают фокус
оно имеет легкие украшения, такие как уменьшенная область перетаскивания без заголовка

Однако фактическое поведение по этим трем пунктам зависит от платформы.

Заголовок может отображаться или нет, в зависимости от фактического типа созданного окна.

Методы ввода должны вызвать Window.dispose на возвращенном окне метода ввода, когда оно больше не требуется.

Параметры:: title - заголовок, который должен отображаться в строке заголовка окна, если такая строка заголовка есть. Значение null обрабатывается как пустая строка, "".; attachToInputContext - нужно ли этому окну совместно использовать контекст ввода, соответствующий этому контексту метода ввода
Возвращает:: JFrame со специальными характеристиками для использования методами ввода
Исключения:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
С:: 1.4

enableClientWindowNotification

void enableClientWindowNotification(InputMethod inputMethod, boolean enable)

Включает или отключает уведомление о местоположении и состоянии текущего клиентского окна для указанного метода ввода. При включенном уведомлении метод метода ввода notifyClientWindowChange вызывается, как описано в спецификации этого метода. Уведомление автоматически отключается при удалении метода ввода.

Параметры:: inputMethod - метод ввода, для которого уведомления включены или отключены; enable - true для включения, false для отключения

© 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/InputMethodContext.html