java.awt.im.spi

Interface InputMethodContext

All Superinterfaces:

InputMethodRequests

public interface InputMethodContext
extends InputMethodRequests

提供方法，输入方法可以用来与他们的客户端组件进行通信或请求其他服务。该接口由输入法框架的实施，和输入方法叫他们获得通过 InputMethod.setInputMethodContext(java.awt.im.spi.InputMethodContext)实例方法。不应该有其他的用户或用户。

从以下版本开始：

一点三

方法摘要

Modifier and Type	Method and Description
JFrame	createInputMethodJFrame(String title, boolean attachToInputContext) 创建使用的输入法的顶级摇摆功能。
Window	createInputMethodWindow(String title, boolean attachToInputContext) 通过输入方法创建一个顶级窗口。
void	dispatchInputMethodEvent(int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition) 创建从给定的参数输入法事件分派到客户端组件。
void	enableClientWindowNotification(InputMethod inputMethod, boolean enable) 启用或禁用当前客户端窗口的位置和状态的通知，用于指定的输入方法。

Methods inherited from interface java.awt.im.InputMethodRequests

cancelLatestCommittedText, getCommittedText, getCommittedTextLength, getInsertPositionOffset, getLocationOffset, getSelectedText, getTextLocation

方法详细信息

dispatchInputMethodEvent

void dispatchInputMethodEvent(int id,
                              AttributedCharacterIterator text,
                              int committedCharacterCount,
                              TextHitInfo caret,
                              TextHitInfo visiblePosition)

创建从给定的参数输入法事件分派到客户端组件。争吵，看到 InputMethodEvent.InputMethodEvent(java.awt.Component, int, java.awt.font.TextHitInfo, java.awt.font.TextHitInfo)。

createInputMethodWindow

Window createInputMethodWindow(String title,
                               boolean attachToInputContext)

通过输入方法创建一个顶级窗口。这个窗口的预期行为是：

• 它漂浮在所有文档窗口和对话框
• 它和它包含的所有组件都没有接收焦点
• 它有重量轻的装饰，如减少拖曳区域没有标题

然而，就这三项的实际行为是依赖于平台。

标题可能或可能不显示，这取决于创建的窗口的实际类型。

如果attachtoinputcontext是真实的，新的窗口将对应于该输入法的输入上下文语境，使事件在窗口组件自动发送到输入法。另外，当窗口打开使用setVisible（true），输入上下文将防止失活和激活调用输入法，否则可能会引起。

输入方法必须调用Window.dispose在返回输入法窗口时，它不再需要。

参数

title -标题是窗口标题栏中显示出来，如果有这样的一个标题栏。一个 null值为空字符串“”。

attachToInputContext——无论这个窗口应该分享对应于该输入法的输入上下文语境

结果

具有用于输入方法的特殊特性的窗口

异常

HeadlessException -如果 GraphicsEnvironment.isHeadless 返回 true

createInputMethodJFrame

JFrame createInputMethodJFrame(String title,
                               boolean attachToInputContext)

创建使用的输入法的顶级摇摆功能。这个窗口的预期行为是：

• 它漂浮在所有文档窗口和对话框
• 它和它包含的所有组件都没有接收焦点
• 它有重量轻的装饰，如减少拖曳区域没有标题

然而，就这三项的实际行为是依赖于平台。

标题可能或可能不显示，这取决于创建的窗口的实际类型。

如果attachtoinputcontext是真实的，新的窗口将对应于该输入法的输入上下文语境，使事件在窗口组件自动发送到输入法。另外，当窗口打开使用setVisible（true），输入上下文将防止失活和激活调用输入法，否则可能会引起。

输入方法必须调用返回的输入法窗口Window.dispose当不再需要它。

参数

title -标题是窗口标题栏中显示出来，如果有这样的一个标题栏。一个 null值为空字符串“”。

attachToInputContext——无论这个窗口应该分享对应于该输入法的输入上下文语境

结果

JFrame特色使用的输入方法

异常

HeadlessException -如果 GraphicsEnvironment.isHeadless 返回 true

从以下版本开始：

一点四

enableClientWindowNotification

void enableClientWindowNotification(InputMethod inputMethod,
                                    boolean enable)

启用或禁用当前客户端窗口的位置和状态的通知，用于指定的输入方法。当通知被启用，输入法的 notifyClientWindowChange方法称为该方法的描述。当输入方法处理时自动禁用通知。

参数

inputMethod -输入方法，通知启用或禁用

enable真使，假禁用