Класс 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)

Устанавливает подмножества набора символов Юникода, которые методы ввода данного контекста ввода должны иметь право вводить. Может быть передан 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 для контекста ввода по умолчанию каждого окна. Если методы ввода недоступны, то этот метод не оказывает никакого влияния.

public Object getInputMethodControlObject()

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

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