InputMethod (Java Platform SE 8 )

```
public interface InputMethod
```
定义支持复杂文本输入的输入方法的接口。输入方法传统上支持文本输入的语言，有更多的字符比可以表示在一个标准尺寸的键盘，如中国，日本和韩国。然而，它们也可以被用来支持泰国英文或字符排序的语音文本输入。
子类的输入法可以通过输入法框架加载；他们可以通过API的选择（InputContext.selectInputMethod）或用户界面（输入法选择菜单）。

从以下版本开始：

一点三

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`void`	`activate()` 激活立即输入处理的输入法。
`void`	`deactivate(boolean isTemporary)` 关闭输入法。
`void`	`dispatchEvent(AWTEvent event)` 发送事件到输入法。
`void`	`dispose()` 释放该输入法所使用的资源。
`void`	`endComposition()` 结束当前上下文中可能正在进行的任何输入组合。
`Object`	`getControlObject()` 从该输入法返回一个控制对象，或为。
`Locale`	`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)
```
    尝试设置输入区域设置。如果输入方法支持所需的区域设置，它将改变其行为，以支持区域设置的输入，并返回真实的。否则，它返回错误，并不会改变其行为。
    这种方法被称为
    - 通过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)
```
    启用或禁用该输入法组成，根据参数的值
    一种用于组合的输入方法解释了用于组成和控制目的的传入事件，而一个禁用的输入方法不解释事件的组合物。请注意，事件被传递到输入方法，无论它是否被启用或不，和一个输入方法，是禁用的组成仍然可以解释事件的控制目的，包括启用或禁用自己的组成。
    
    对于由主机操作系统提供的输入方法，它不总是可能的，以确定是否支持此操作。例如，一个输入法只能用于某些地区使组成，和其他地方做什么。这种输入方法，它是可能的，这种方法不把UnsupportedOperationException，又不影响是否构成启用。
    
    这种方法被称为
    - 通过InputContext.setCompositionEnabled，
    - 当切换到这个输入法从不同的用户界面或InputContext.selectInputMethod，如果先前选定的输入法的isCompositionEnabled方法返回不抛出异常。
    enable。
    参数
    
    enable -是否启用对组成的输入法
    
    异常
    
    UnsupportedOperationException -如果这个输入法不支持启用/禁用操作
    
    另请参见：
    
    isCompositionEnabled()
  - isCompositionEnabled
```
boolean isCompositionEnabled()
```
    确定是否启用了此输入方法。一种用于组合的输入方法解释了用于组成和控制目的的传入事件，而一个禁用的输入方法不解释事件的组合物。
    这种方法被称为
    - 通过InputContext.isCompositionEnabled和
    - 从这个输入法切换到一个不同的用户界面或InputContext.selectInputMethod时使用。
    结果
    
    true如果本输入法功能的成分； false否则。
    
    异常
    
    UnsupportedOperationException -如果这个输入法不支持检查是否启用组成
    
    另请参见：
    
    setCompositionEnabled(boolean)
  - reconvert
```
void reconvert()
```
    启动恢复操作。输入法得到的文本被转化利用 InputMethodRequests.getSelectedText方法当前的客户端组件。它可以使用其他 InputMethodRequests方法要求恢复操作所需的额外信息。的组成和致力于文本的操作是一个序列的 InputMethodEvents发送到客户端组件。如果给定的文本不能转回，相同的文本应该被发送到客户端组件作为致力于文本。
    这种方法被称为InputContext.reconvert。
    
    异常
    
    UnsupportedOperationException -如果输入法不支持恢复操作。
  - dispatchEvent
```
void dispatchEvent(AWTEvent event)
```
    发送事件到输入法。如果为集中的组件启用了输入法支持，在它们被发送到组件的方法或事件侦听器之前，某些类型的传入事件将被发送到该组件的当前输入方法。输入方法决定是否需要处理事件。如果是这样，这也叫事件的 consume法；这使得事件不被派遣到组件的事件处理方法或事件监听器。
    事件派遣他们是否有inputevent或其子类的实例。keyEvent包括AWT事件类和实例。
    
    这种方法被称为InputContext.dispatchEvent。
    
    参数
    
    event -事件被派遣到输入法
    
    异常
    
    NullPointerException -如果 event是空的
  - notifyClientWindowChange
```
void notifyClientWindowChange(Rectangle bounds)
```
    通知本输入法在客户端窗口的位置或状态的变化。这种方法是在输入法是它的输入上下文和通知的当前输入法称为启用（见 InputMethodContext.enableClientWindowNotification）。调用这个方法暂时如果输入上下文的 removeNotify方法叫暂停，恢复时，输入法是一个新的客户端组件激活。它被称为在下列情况
    - 当窗口包含位置、规模、知名度，iconification国家当前的客户端组件的变化，或当窗口关闭。
    - 从 enableClientWindowNotification(inputMethod, true)如果当前的客户端组件的存在，
    - 当激活首次输入法后为enableClientWindowNotification(inputMethod, true)如果调用没有当前客户端组件中是可用的，
    - 当激活新的客户端组件的输入法在输入上下文的方法被称为removenotify。
    参数
    
    bounds客户端窗口的 bounds屏幕上；或null如果客户端窗口图标化或看不见的
  - activate
```
void activate()
```
    激活立即输入处理的输入法。
    如果一个输入法提供了它自己的窗口，它应该确保在这一点上，所有必要的窗口是开放的和可见的。
    
    这种方法被称为
    - 通过InputContext.dispatchEvent当客户端组件接收到一个focus_gained事件，
    - 当切换到这个输入法从不同的用户界面或InputContext.selectInputMethod。
    方法只叫当输入法是无效的。一个新实例化的输入法被认为是无效的。
  - deactivate
```
void deactivate(boolean isTemporary)
```
    关闭输入法。这是短期的参数具有相同的含义是在 FocusEvent.isTemporary。
    如果一个输入法提供了它自己的窗口，只有与当前的组合（如查找选择窗口）有关的窗口应该在这一点上关闭。这是可能的，输入法将立即重新激活一个不同的客户端组件，然后关闭并重新打开更持久的Windows（如控制面板）将会造成不必要的屏幕闪烁。在不同的输入法类的一个实例被激活，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。
  - dispose
```
void dispose()
```
    释放该输入法所使用的资源。特别是，输入方法应处理窗口和关闭不再需要的文件。
    这种方法被称为InputContext.dispose。
    
    该方法仅当输入方法无效时才调用。此接口的任何方法都在处理后调用此实例。
  - getControlObject
```
Object getControlObject()
```
    从该输入法返回一个控制对象，或为。一个控制对象提供了控制输入法的行为或从输入法获取信息的方法。对象的类型是一个输入法特定的类。客户端必须将结果与已知的输入法控制对象类进行比较，并将其转换为适当的类，以调用提供的方法。
    这种方法被称为InputContext.getInputMethodControlObject。
    
    结果
    
    从该输入法的控制对象或空

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface InputMethod

方法摘要

方法详细信息

setInputMethodContext

setLocale

getLocale

setCharacterSubsets

setCompositionEnabled

isCompositionEnabled

reconvert

dispatchEvent

notifyClientWindowChange

activate

deactivate

hideWindows

removeNotify

endComposition

dispose

getControlObject