java.awt.im

Класс InputContext

java.lang. Объект

java.awt.im. InputContext

public class InputContext
extends Object

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

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

Платформа Java поддерживает входные методы, которые были разработаны в языке программирования Java, используя интерфейсы в java.awt.im.spi пакет, и установленный в Java Среда выполнения SE как расширения. Реализации могут также поддерживать использование собственных входных методов платформ, на которых они работают; однако, не все платформы и локали обеспечивают входные методы. Раскладки клавиатуры обеспечиваются платформой узла.

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

С тех пор:

1.2

См. Также:

Component.getInputContext(), Component.enableInputMethods(boolean)

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	InputContext() Создает InputContext.

Сводка метода

Модификатор и Тип	Метод и Описание
void	dispatchEvent(AWTEvent event) Диспетчеризирует событие активному входному методу.
void	dispose() Высвобождает средства, используемые этим входным контекстом.
void	endComposition() Концы любой входной состав, который может в настоящий момент продолжаться в этом контексте.
Объект	getInputMethodControlObject() Возвращает объект управления из текущего входного метода, или нуль.
static InputContext	getInstance() Возвращает новый экземпляр InputContext.
Локаль	getLocale() Возвращает текущую локаль текущего входного метода или раскладки клавиатуры.
boolean	isCompositionEnabled() Определяет, включается ли текущий входной метод для состава.
void	reconvert() Просит текущий входной метод повторно преобразовывать текст из текущего клиентского компонента.
void	removeNotify(Component client) Уведомляет входной контекст, что клиентский компонент был удален из его иерархии включения, или что входная поддержка метода была отключена для компонента.
boolean	selectInputMethod(Locale locale) Попытки выбрать входной метод или раскладку клавиатуры, которая поддерживает данную локаль, и возвращает значение, указывающее, были ли такой входной метод или раскладка клавиатуры успешно выбраны.
void	setCharacterSubsets(Character.Subset[] subsets) Устанавливает подмножества набора символов Unicode, который входным методам этого входного контекста нужно позволить ввести.
void	setCompositionEnabled(boolean enable) Включает или отключает текущий входной метод для состава, в зависимости от значения параметра enable.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

InputContext

protected InputContext()

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

Деталь метода

getInstance

public static InputContext getInstance()

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

selectInputMethod

public boolean selectInputMethod(Locale locale)

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

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

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

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

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

Параметры:

locale - Требуемая новая локаль.

Возвраты:

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

Броски:

NullPointerException - если locale нуль

getLocale

public Locale getLocale()

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

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

Возвраты:

текущая локаль текущего входного метода или раскладки клавиатуры

С тех пор:

1.3

setCharacterSubsets

public void setCharacterSubsets(Character.Subset[] subsets)

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

Параметры:

subsets - Подмножества набора символов Unicode, от которого могут быть введены символы

setCompositionEnabled

public void setCompositionEnabled(boolean enable)

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

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

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

Параметры:

enable - включить ли текущему входному методу для состава

Броски:

UnsupportedOperationException - если нет никакого текущего входного доступного метода, или текущий входной метод не поддерживает работу включения/отключения

С тех пор:

1.3

См. Также:

isCompositionEnabled()

isCompositionEnabled

public boolean isCompositionEnabled()

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

Возвраты:

true если текущий входной метод включается для состава; false иначе

Броски:

UnsupportedOperationException - если нет никакого текущего входного доступного метода, или текущий входной метод не поддерживает проверку, включается ли это для состава

С тех пор:

1.3

См. Также:

setCompositionEnabled(boolean)

повторно преобразовать

public void reconvert()

Просит текущий входной метод повторно преобразовывать текст из текущего клиентского компонента. Входной метод получает текст, который будет повторно преобразован из клиентского компонента, используя InputMethodRequests.getSelectedText метод. Другой InputMethodRequests методы должны быть подготовлены иметь дело с запросами дополнительной информации входным методом. Составленный и/или фиксировавший текст будет отправлен клиентскому компоненту как последовательность InputMethodEvents. Если входной метод не может повторно преобразовать данный текст, текст возвращается как фиксировавший текст в InputMethodEvent.

Броски:

UnsupportedOperationException - если нет никакого текущего входного доступного метода, или текущий входной метод не поддерживает работу обратного преобразования.

С тех пор:

1.3

dispatchEvent

public void dispatchEvent(AWTEvent event)

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

Параметры:

event - Событие

Броски:

NullPointerException - если event нуль

removeNotify

public void removeNotify(Component client)

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

Параметры:

client - Клиентский компонент

Броски:

NullPointerException - если client нуль

endComposition

public void endComposition()

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

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

расположить

public void dispose()

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

getInputMethodControlObject

public Object getInputMethodControlObject()

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

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

Возвраты:

Объект управления от текущего входного метода, или нуль.