Интерфейс 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).

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, 2020, 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.