InputMethod (Платформа Java SE 7)

```
public interface InputMethod
```
Определяет интерфейс для входного метода, который поддерживает сложный текстовый ввод. Входные методы традиционно поддерживают текстовый ввод для языков, у которых есть больше символов, чем можно представить на клавиатуре стандартного размера, такой как китайский, японский, и корейский язык. Однако, они могут также использоваться, чтобы поддерживать фонетический текстовый ввод для английского языка или переупорядочение символа для тайского языка.
Подклассы InputMethod могут быть загружены входной платформой метода; они могут тогда быть выбраны любой через API (InputContext.selectInputMethod) или пользовательский интерфейс (входное меню выбора метода).

С тех пор:

1.3

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

Методы
Модификатор и Тип	Метод и Описание
`void`	`activate()` Активирует входной метод для непосредственной входной обработки.
`void`	`deactivate(boolean isTemporary)` Деактивировал входной метод.
`void`	`dispatchEvent(AWTEvent event)` Диспетчеризирует событие входному методу.
`void`	`dispose()` Высвобождает средства, используемые этим входным методом.
`void`	`endComposition()` Концы любой входной состав, который может в настоящий момент продолжаться в этом контексте.
`Объект`	`getControlObject()` Возвращает объект управления из этого входного метода, или нуль.
`Локаль`	`getLocale()` Возвращает текущую входную локаль.
`void`	`hideWindows()` Завершения или скрывают все окна, открытые этим входным экземпляром метода или его классом.
`boolean`	`isCompositionEnabled()` Определяет, включается ли этот входной метод.
`void`	`notifyClientWindowChange(Rectangle bounds)` Уведомляет этот входной метод изменений в клиентском расположении окна или состоянии.
`void`	`reconvert()` Запускает работу обратного преобразования.
`void`	`removeNotify()` Уведомляет входной метод, что клиентский компонент был удален из его иерархии включения, или что входная поддержка метода была отключена для компонента.
`void`	`setCharacterSubsets(Character.Subset[] subsets)` Устанавливает подмножества набора символов Unicode, который этому входному методу позволяют ввести.
`void`	`setCompositionEnabled(boolean enable)` Включения или отключения этот входной метод для состава, в зависимости от значения параметра `enable`.
`void`	`setInputMethodContext(InputMethodContext context)` Устанавливает входной контекст метода, который используется, чтобы диспетчеризировать входные события метода клиентскому компоненту и запросить информацию от клиентского компонента.
`boolean`	`setLocale(Locale locale)` Попытки установить входную локаль.

- Деталь метода
  - setInputMethodContext
```
void setInputMethodContext(InputMethodContext context)
```
    Устанавливает входной контекст метода, который используется, чтобы диспетчеризировать входные события метода клиентскому компоненту и запросить информацию от клиентского компонента.
    Этот метод вызывают однажды сразу после инстанцирования этого входного метода.
    
    Параметры:
    context - входной контекст метода для этого входного метода
    
    Броски:
    
    NullPointerException - если context нуль
  - setLocale
```
boolean setLocale(Locale locale)
```
    Попытки установить входную локаль. Если входной метод поддерживает требуемую локаль, он изменяет свое поведение, чтобы поддерживать ввод для локали и возвращает true. Иначе, это возвращает false и не изменяет его поведение.
    Этот метод вызывают
    - InputContext.selectInputMethod,
    - переключаясь на этот входной метод через пользовательский интерфейс, если пользователь, определенный локаль или если ранее выбранный входной метод getLocale метод возвращает ненулевое значение.
    Параметры:
    locale - локаль, чтобы ввести
    
    Возвраты:
    поддерживается ли указанная локаль
    
    Броски:
    
    NullPointerException - если locale нуль
  - getLocale
```
Locale getLocale()
```
    Возвращает текущую входную локаль. Мог бы возвратить нуль в исключительных случаях.
    Этот метод вызывают
    - InputContext.getLocale и
    - переключаясь от этого входного метода до различного через пользовательский интерфейс.
    Возвраты:
    текущая входная локаль, или нуль
  - setCharacterSubsets
```
void setCharacterSubsets(Character.Subset[] subsets)
```
    Устанавливает подмножества набора символов Unicode, который этому входному методу позволяют ввести. Нуль можно передать в указать, что все символы позволяются.
    Этот метод вызывают
    - сразу после инстанцирования этого входного метода,
    - переключаясь на этот входной метод от различного, и
    - InputContext.setCharacterSubsets.
    Параметры:
    subsets - подмножества набора символов Unicode, от которого могут быть введены символы
  - setCompositionEnabled
```
void setCompositionEnabled(boolean enable)
```
    Включения или отключения этот входной метод для состава, в зависимости от значения параметра enable.
    Входной метод, который включается для состава, интерпретирует входящие события и для состава и для целей управления, в то время как отключенный входной метод не интерпретирует события для состава. Отметьте однако, что события передаются входному методу независимо, включается ли он или нет, и что входной метод, который отключается для состава, может все еще интерпретировать события в целях управления, включая включить или отключить себя для состава.
    Для входных методов, обеспеченных операционными системами узла, не всегда возможно определить, поддерживается ли эта работа. Например, входной метод может включить составу только для некоторых локалей, и ничего не сделать для других локалей. Для таких входных методов возможно, что этот метод не бросает UnsupportedOperationException, но также и не влияет, включается ли состав.
    Этот метод вызывают
    - InputContext.setCompositionEnabled,
    - переключаясь на этот входной метод от различного, используя пользовательский интерфейс или InputContext.selectInputMethod, если ранее выбранный входной метод isCompositionEnabled метод возвращается, не выдавая исключение.
    Параметры:
    enable - включить ли входному методу для состава
    
    Броски:
    
    UnsupportedOperationException - если этот входной метод не поддерживает работу включения/отключения
    См. Также:
    isCompositionEnabled()
  - isCompositionEnabled
```
boolean isCompositionEnabled()
```
    Определяет, включается ли этот входной метод. Входной метод, который включается для состава, интерпретирует входящие события и для состава и для целей управления, в то время как отключенный входной метод не интерпретирует события для состава.
    Этот метод вызывают
    - InputContext.isCompositionEnabled и
    - переключаясь от этого входного метода до различного, используя пользовательский интерфейс или InputContext.selectInputMethod.
    Возвраты:
    true если этот входной метод включается для состава; false иначе.
    
    Броски:
    
    UnsupportedOperationException - если этот входной метод не поддерживает проверку, включается ли это для состава
    См. Также:
    setCompositionEnabled(boolean)
  - повторно преобразовать
```
void reconvert()
```
    Запускает работу обратного преобразования. Входной метод получает текст, который будет повторно преобразован из текущего клиентского компонента, используя InputMethodRequests.getSelectedText метод. Это может использовать другой InputMethodRequests методы, чтобы запросить дополнительную информацию, требуемую на работу обратного преобразования. Составленный и фиксировавший текст, произведенный работой, отправляется клиентскому компоненту как последовательность InputMethodEvents. Если данный текст не может быть повторно преобразован, тот же самый текст должен быть отправлен клиентскому компоненту как фиксировавший текст.
    Этим методом вызывают InputContext.reconvert.
    
    Броски:
    
    UnsupportedOperationException - если входной метод не поддерживает работу обратного преобразования.
  - dispatchEvent
```
void dispatchEvent(AWTEvent event)
```
    Диспетчеризирует событие входному методу. Если входная поддержка метода включается для фокусируемого компонента, входящие события определенных типов диспетчеризируются текущему входному методу для этого компонента прежде, чем они будут диспетчеризированы методам компонента или слушателям события. Входной метод решает, должен ли он обработать событие. Если это делает, это также вызывает событие consume метод; это заставляет событие не быть диспетчеризированным методам обработки событий компонента или слушателям события.
    События диспетчеризируются, если они - экземпляры InputEvent или его подклассов. Это включает экземпляры классов AWT KeyEvent и MouseEvent.
    Этим методом вызывают InputContext.dispatchEvent.
    
    Параметры:
    event - событие, диспетчеризируемое входному методу
    
    Броски:
    
    NullPointerException - если event нуль
  - notifyClientWindowChange
```
void notifyClientWindowChange(Rectangle bounds)
```
    Уведомляет этот входной метод изменений в клиентском расположении окна или состоянии. Этот метод вызывают, в то время как этот входной метод является текущим входным методом своего входного контекста, и уведомления для этого включаются (см. InputMethodContext.enableClientWindowNotification). Звонки в этот метод временно приостанавливаются если входной контекст removeNotify метод вызывают, и резюме, когда входной метод активируется для нового клиентского компонента. Это вызывают в следующих ситуациях:
    - когда окно, содержащее текущий клиентский компонент, изменяется в расположении, размере, видимости, iconification состояние, или когда окно закрывается.
    - от enableClientWindowNotification(inputMethod, true) если текущий клиентский компонент существует,
    - активируя входной метод впервые после того, как это вызывало enableClientWindowNotification(inputMethod, true) если во время вызова никакой текущий клиентский компонент не был доступен,
    - активируя входной метод для нового клиентского компонента после того, как removeNotify метод контекста ввода вызвали.
    Параметры:
    bounds - клиентское окно bounds на экране; или нуль, если клиентское окно представляется в виде значка или невидимо
  - активироваться
```
void activate()
```
    Активирует входной метод для непосредственной входной обработки.
    Если входной метод обеспечивает свои собственные окна, он должен удостовериться в этой точке, что все необходимые окна открыты и видимы.
    Этот метод вызывают
    - InputContext.dispatchEvent когда клиентский компонент получает событие FOCUS_GAINED,
    - переключаясь на этот входной метод от различного, используя пользовательский интерфейс или InputContext.selectInputMethod.
    Метод только вызывают, когда входной метод неактивен. Недавно инстанцированный входной метод, как предполагается, неактивен.
  - деактивироваться
```
void deactivate(boolean isTemporary)
```
    Деактивировал входной метод. У isTemporary параметра есть то же самое значение как в FocusEvent.isTemporary.
    Если входной метод обеспечивает свои собственные окна, только окна, которые касаются текущего состава (такого как окно выбора поиска) должны закрыться в этой точке. Возможно, что входной метод будет сразу активирован снова для различного клиентского компонента, и закрытие и повторное открытие более персистентных окон (таких как панель управления) создали бы ненужное экранное мерцание. Прежде, чем экземпляр различного входного класса метода активируется, hideWindows() вызывается на текущем входном методе.
    Этот метод вызывают
    - InputContext.dispatchEvent когда клиентский компонент получает событие FOCUS_LOST,
    - переключаясь от этого входного метода до различного, используя пользовательский интерфейс или InputContext.selectInputMethod,
    - прежде removeNotify если текущий клиентский компонент удаляется.
    Метод только вызывают, когда входной метод является активным.
    Параметры:
    isTemporary - является ли изменение фокуса временным
  - hideWindows
```
void hideWindows()
```
    Завершения или скрывают все окна, открытые этим входным экземпляром метода или его классом.
    Этот метод вызывают
    - перед вызовом activate на экземпляре различного входного класса метода,
    - перед вызовом dispose на этом входном методе.
    Метод только вызывают, когда входной метод неактивен.
  - removeNotify
```
void removeNotify()
```
    Уведомляет входной метод, что клиентский компонент был удален из его иерархии включения, или что входная поддержка метода была отключена для компонента.
    Этим методом вызывают InputContext.removeNotify.
    Метод только вызывают, когда входной метод неактивен.
  - endComposition
```
void endComposition()
```
    Концы любой входной состав, который может в настоящий момент продолжаться в этом контексте. В зависимости от платформы и возможно пользовательских настроек, это может фиксировать или удалить незафиксированный текст. Любые изменения к тексту передаются к активному компоненту, используя входное событие метода.
    Компонент редактирования текста может вызвать это во множестве ситуаций, например, когда пользователь перемещает точку вставки в пределах текста (но вне составленного текста), или когда текст компонента сохранен к файлу или скопирован в буфер обмена.
    Этот метод вызывают
    - InputContext.endComposition,
    - InputContext.dispatchEvent переключаясь на различный клиентский компонент
    - переключаясь от этого входного метода до различного, используя пользовательский интерфейс или InputContext.selectInputMethod.
  - расположить
```
void dispose()
```
    Высвобождает средства, используемые этим входным методом. В частности входной метод должен расположить окна и близкие файлы, которые больше не необходимы.
    Этим методом вызывают InputContext.dispose.
    Метод только вызывают, когда входной метод неактивен. Никакой метод этого интерфейса не вызывают на этом экземпляре после того, как располагают.
  - getControlObject
```
Object getControlObject()
```
    Возвращает объект управления из этого входного метода, или нуль. Объект управления обеспечивает методы, которые управляют поведением входного метода или получают информацию из входного метода. Тип объекта является входным методом определенный класс. Клиенты должны сравнить результат с известными входными классами объекта управления метода и бросить к соответствующему классу, чтобы вызвать обеспеченные методы.
    Этим методом вызывают InputContext.getInputMethodControlObject.
    
    Возвраты:
    объект управления от этого входного метода, или нуль

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Интерфейсный InputMethod

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

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

setInputMethodContext

setLocale

getLocale

setCharacterSubsets

setCompositionEnabled

isCompositionEnabled

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

dispatchEvent

notifyClientWindowChange

активироваться

деактивироваться

hideWindows

removeNotify

endComposition

расположить

getControlObject