java.awt.im

Class InputContext

java.lang.Object

java.awt.im.InputContext

public class InputContext
extends Object

提供控制文本输入设备的方法，如输入法和键盘布局。两种方法处理输入方法及键盘布局：selectinputmethod让客户端组件选择输入法或现场的键盘布局，getlocale让客户端组件获得现场的当前输入法和键盘布局。其他方法更具体地支持与输入方法的交互：它们让客户端组件控制输入方法的行为，并将事件从客户端组件发送到输入法。

默认情况下，每一inputcontext实例窗口实例创建，这个输入上下文的所有组件在窗口的容器层次结构共享。然而，这意味着只有一个文本输入操作是可能的，在任何一个时间内的一个窗口，和文本需要提交时，从一个文本组件的焦点到另一个。如果这是不需要的，文本组件可以创建自己的输入上下文实例。

java平台支持的输入方法，已在java编程语言开发，在java.awt.im.spi包使用的接口，并安装到一个java运行环境的延伸。实现可能也支持使用的平台，它们运行在本地输入法；然而，并不是所有的平台和场所提供的输入方法。键盘布局是由主机平台提供的。

输入方法是不可用的（一）如果没有输入法编写的java编程语言已经安装和（B）的java平台实现或基础平台不支持原生输入法。在这种情况下，输入上下文仍然可以被创建和使用；它们的行为被指定为下面的单独的方法。

从以下版本开始：

一点二

另请参见：

Component.getInputContext()， Component.enableInputMethods(boolean)

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	InputContext() 构建了一个inputcontext。

方法摘要

Modifier and Type	Method and Description
void	dispatchEvent(AWTEvent event) 将一个事件活动的输入方法。
void	dispose() 释放此输入上下文所使用的资源。
void	endComposition() 结束当前上下文中可能正在进行的任何输入组合。
Object	getInputMethodControlObject() 从当前输入法返回一个控件对象，或为。
static InputContext	getInstance() 返回一个新的inputcontext实例。
Locale	getLocale() 返回当前输入法或键盘布局的当前区域设置。
boolean	isCompositionEnabled() 确定是否启用了当前的输入法。
void	reconvert() 要将文本从当前的客户端组件的当前输入法。
void	removeNotify(Component client) 当输入的背景下，一个客户端组件已从其层次结构拆除，或输入法支持已被禁用的组件。
boolean	selectInputMethod(Locale locale) 试图选择支持给定区域设置的输入法或键盘布局，并返回一个值，该值指示是否已成功地选择了这样的输入法或键盘布局。
void	setCharacterSubsets(Character.Subset[] subsets) 设置的Unicode字符集，这个输入上下文输入方法应该允许输入的子集。
void	setCompositionEnabled(boolean enable) 启用或禁用成分当前输入法，根据参数的值 enable。

Methods inherited from class java.lang.Object

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

Constructor Detail

InputContext

protected InputContext()

构建了一个inputcontext。这种方法是受保护的，客户不能直接实例化inputcontext。通过调用 getInstance()得到输入上下文。

方法详细信息

getInstance

public static InputContext getInstance()

返回一个新的inputcontext实例。

selectInputMethod

public boolean selectInputMethod(Locale locale)

试图选择支持给定区域设置的输入法或键盘布局，并返回一个值，该值指示是否已成功地选择了这样的输入法或键盘布局。采取以下步骤直到输入法已选定：切换输入法

• 如果当前所选的输入法或键盘布局支持所请求的区域设置，则它仍然选择。
• 如果没有输入法或键盘布局，支持所请求的区域设置，当前的输入法或键盘布局仍然选择。
• 如果用户已选定的输入法和键盘布局的要求现场从用户界面，然后最近选择输入法和键盘布局选择。
• 否则，在实现依赖方式中选择支持所请求的区域设置的输入法或键盘布局。

离开之前，任何目前未提交文本承诺。如果没有可用的输入法或键盘布局，支持所请求的区域设置，则返回假。

并不是所有的主机操作系统都提供了原料药，以确定当前选定的本地输入法或键盘布局的区域设置，并选择一个本地输入法或键盘布局的现场设置。主机的操作系统，不提供这样的API，selectInputMethod假设原生输入法及键盘布局由主机操作系统只支持系统默认区域设置。

一个文本编辑组件可以调用此方法，例如，当用户改变插入点时，以便用户可以立即继续在围绕文本的语言中键入。

参数

locale -所需的新的区域。

结果

如果此调用后的输入法或键盘布局支持所需的区域设置，则是真的。

异常

NullPointerException -如果 locale是空的

getLocale

public Locale getLocale()

返回当前输入法或键盘布局的当前区域设置。如果输入上下文不如果当前输入法的 InputMethod.getLocale()方法返回null有当前的输入法和键盘布局或返回null。

并不是所有的主机操作系统提供的接口，以确定当前选定的本地输入法或键盘布局的区域设置。主机的操作系统，不提供这样的API，getLocale假定所有原生输入法和键盘布局由主机操作系统提供的当前区域设置是系统默认的区域设置。

结果

当前输入法或键盘布局的当前区域设置

从以下版本开始：

一点三

setCharacterSubsets

public void setCharacterSubsets(Character.Subset[] subsets)

设置的Unicode字符集，这个输入上下文输入方法应该允许输入的子集。可以传递为空，以指示所有字符都是允许的。初始值为空。该设置适用于当前输入法，以及在此调用后选择的输入方法。然而，应用程序不能依赖这个调用具有所需的效果，因为这个设置不能传递给所有的主机输入方法-应用程序仍然需要应用自己的字符验证。如果没有可用的输入方法，那么这种方法没有任何效果。

参数

subsets的子集的Unicode字符集的字符可以输入

setCompositionEnabled

public void setCompositionEnabled(boolean enable)

启用或禁用成分当前输入法，根据参数的值

一种用于组合的输入方法解释了用于组成和控制目的的传入事件，而一个禁用的输入方法不解释事件的组合物。请注意，事件被传递到输入方法，无论它是否被启用或不，和一个输入方法，是禁用的组成仍然可以解释事件的控制目的，包括启用或禁用自己的组成。

对于由主机操作系统提供的输入方法，它不总是可能的，以确定是否支持此操作。例如，一个输入法只能用于某些地区使组成，和其他地方做什么。这种输入方法，它是可能的，这种方法不把UnsupportedOperationException，又不影响是否构成启用。

enable。

参数

enable -是否启用对构成当前输入法

异常

UnsupportedOperationException -如果没有当前输入法可用或当前输入法不支持启用/禁用操作

从以下版本开始：

一点三

另请参见：

isCompositionEnabled()

isCompositionEnabled

public boolean isCompositionEnabled()

确定是否启用了当前的输入法。一种用于组合的输入方法解释了用于组成和控制目的的传入事件，而一个禁用的输入方法不解释事件的组合物。

结果

true如果当前输入法功能的成分； false否则

异常

UnsupportedOperationException -如果没有当前输入法可用或当前的输入法不支持检查是否启用组成

从以下版本开始：

一点三

另请参见：

setCompositionEnabled(boolean)

reconvert

public void reconvert()

要将文本从当前的客户端组件的当前输入法。输入法得到的文本被转化利用 InputMethodRequests.getSelectedText方法的客户端组件。另 InputMethodRequests方法必须准备应对进一步的信息请求的输入法。的组成和/或提交的文本将作为一系列 InputMethodEvents发送到客户端组件。如果输入法不能将给定的文本，文本是作为犯在 InputMethodEvent返回文本。

异常

UnsupportedOperationException -如果没有当前输入法可用或当前输入法不支持恢复操作。

从以下版本开始：

一点三

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()

结束当前上下文中可能正在进行的任何输入组合。根据平台和可能的用户的喜好，这可能提交或删除未提交的文本。任何对文本的更改都使用输入法事件传递给活动组件。如果没有可用的输入方法，那么这种方法没有任何效果。

文本编辑组件可以在各种情况下调用此组件，例如，当用户在文本中移动插入点（但在所合成的文本之外），或者当组件的文本保存到文件或复制到剪贴板时。

dispose

public void dispose()

释放此输入上下文所使用的资源。由AWT为每个窗口的默认的输入上下文。如果没有可用的输入方法，那么这种方法没有任何效果。

getInputMethodControlObject

public Object getInputMethodControlObject()

从当前输入法返回一个控件对象，或为。一个控制对象提供了控制输入法的行为或从输入法获取信息的方法。对象的类型是一个输入法特定的类。客户端必须将结果与已知的输入法控制对象类进行比较，并将其转换为适当的类，以调用提供的方法。

如果没有可用的输入方法或当前的输入法不提供一个输入法控制对象，则返回空值。

结果

从当前输入法的控制对象，或空。