Класс InputContext

protected InputContext()

Создает InputContext. Этот метод является защищенным, поэтому клиенты не могут создавать экземпляры InputContext напрямую. Контексты ввода получают с помощью вызова getInstance().

public static InputContext getInstance()

Возвращает новый экземпляр InputContext.

public boolean selectInputMethod(Locale locale)

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

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

Перед переключением с метода ввода фиксируется любой незавершенный текст. Если метод ввода или раскладка клавиатуры, поддерживающие запрошенную локаль, недоступны, возвращается false.

Не все хост-операционные системы предоставляют API для определения локали текущего выбранного встроенного метода ввода или раскладки клавиатуры и выбора встроенного метода ввода или раскладки клавиатуры по локали. Для хост-операционных систем, не предоставляющих такой API, selectInputMethod предполагает, что встроенные методы ввода или раскладки клавиатуры, предоставляемые хост-операционной системой, поддерживают только системную локаль по умолчанию.

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

public Locale getLocale()

Возвращает текущую локаль текущего метода ввода или раскладки клавиатуры. Возвращает null, если у контекста ввода нет текущего метода ввода или раскладки клавиатуры либо если метод InputMethod.getLocale() текущего метода ввода возвращает null.

Не все хост-операционные системы предоставляют API для определения локали текущего выбранного встроенного метода ввода или раскладки клавиатуры. Для хост-операционных систем, не предоставляющих такой API, getLocale предполагает, что текущая локаль всех встроенных методов ввода или раскладок клавиатуры, предоставляемых хост-операционной системой, совпадает с системной локалью по умолчанию.

public void setCharacterSubsets(Character.Subset[] subsets)

Задает подмножества набора символов Unicode, ввод которых должен быть разрешен методам ввода этого контекста ввода. Значение null можно передать, чтобы указать, что разрешены все символы. Начальное значение — null. Настройка применяется как к текущему методу ввода, так и к методам ввода, выбранным после вызова этого метода. Однако приложения не могут рассчитывать на то, что этот вызов даст желаемый результат, поскольку передать эту настройку всем хост-методам ввода невозможно; приложениям по-прежнему необходимо выполнять собственную проверку символов. Если методы ввода недоступны, этот метод ничего не делает.

public void setCompositionEnabled(boolean enable)

Включает или отключает текущий метод ввода для композиции в зависимости от значения параметра enable.

Метод ввода, включенный для композиции, интерпретирует входящие события как для композиции, так и для управления, тогда как отключенный метод ввода не интерпретирует события для композиции. Однако следует учитывать, что события передаются методу ввода независимо от того, включен он или нет, и что метод ввода, отключенный для композиции, все еще может интерпретировать события для управления, в том числе для включения или отключения композиции.

Для методов ввода, предоставляемых хост-операционными системами, не всегда можно определить, поддерживается ли эта операция. Например, метод ввода может включать композицию только для некоторых локалей и ничего не делать для других локалей. Для таких методов ввода этот метод может не выбросить UnsupportedOperationException, но при этом не повлиять на состояние композиции.

public boolean isCompositionEnabled()

Определяет, включен ли текущий метод ввода для композиции. Метод ввода, включенный для композиции, интерпретирует входящие события как для композиции, так и для управления, тогда как отключенный метод ввода не интерпретирует события для композиции.

public void reconvert()

Запрашивает у текущего метода ввода повторное преобразование текста из текущего клиентского компонента. Метод ввода получает текст для повторного преобразования из клиентского компонента с помощью метода InputMethodRequests.getSelectedText. Остальные методы InputMethodRequests должны быть готовы обрабатывать дальнейшие запросы метода ввода. Составленный и/или зафиксированный текст будет передан клиентскому компоненту в виде последовательности объектов InputMethodEvent. Если метод ввода не может выполнить повторное преобразование указанного текста, текст возвращается как зафиксированный текст в объекте InputMethodEvent.

public void dispatchEvent(AWTEvent event)

Передает событие активному методу ввода. Вызывается AWT. Если методы ввода недоступны, событие никогда не будет обработано методом ввода.

public void removeNotify(Component client)

Уведомляет контекст ввода о том, что клиентский компонент удален из иерархии контейнеров или для компонента отключена поддержка методов ввода. Обычно этот метод вызывается из метода Component.removeNotify клиентского компонента. Потенциально ожидающий ввод от методов ввода для этого компонента отбрасывается. Если методы ввода недоступны, этот метод ничего не делает.

public void endComposition()

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

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

public void dispose()

Освобождает ресурсы, используемые этим контекстом ввода. Вызывается AWT для контекста ввода по умолчанию каждого Window. Если методы ввода недоступны, этот метод ничего не делает.

public Object getInputMethodControlObject()

Возвращает управляющий объект текущего метода ввода или null. Управляющий объект предоставляет методы для управления поведением метода ввода или получения информации от него. Тип объекта — класс, специфичный для метода ввода. Клиенты должны сравнить результат с известными классами управляющих объектов методов ввода и привести его к соответствующему классу, чтобы вызвать предоставляемые методы.

Если методы ввода недоступны или текущий метод ввода не предоставляет управляющий объект, возвращается null.