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