Интерфейс InputMethodContext

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

public interface InputMethodContext extends InputMethodRequests

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

Начиная с:: 1.3

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

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

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

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

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

dispatchInputMethodEvent

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

Создает событие метода ввода из заданных аргументов и отправляет его клиентскому компоненту. Описание аргументов см. в InputMethodEvent(Component, int, TextHitInfo, 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)

Создает JFrame верхнего уровня Swing для использования методом ввода. Предполагается, что это окно будет вести себя следующим образом:

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

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

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

Когда возвращенное окно метода ввода больше не требуется, методы ввода должны вызвать для него 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, 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/InputMethodContext.html