java.awt.im.spi
介面 InputMethodContext

所有父級介面：

InputMethodRequests

public interface InputMethodContext
extends InputMethodRequests

提供輸入方法可以用來與其客戶端元件通信或用來請求其他服務的方法。此介面由輸入方法框架實作，並且輸入方法針對其通過 InputMethod.setInputMethodContext(java.awt.im.spi.InputMethodContext) 收到的實例調用其方法。此外再沒有其他實作程序或調用者。

從以下版本開始：

1.3

方法摘要

JFrame	createInputMethodJFrame(String title, boolean attachToInputContext) 創建輸入方法使用的頂層 Swing JFrame。
Window	createInputMethodWindow(String title, boolean attachToInputContext) 創建輸入方法使用的頂層視窗。
void	dispatchInputMethodEvent(int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition) 根據給定的參數創建輸入方法事件並將其指派到客戶端元件。
void	enableClientWindowNotification(InputMethod inputMethod, boolean enable) 啟用或禁用指定輸入方法的當前客戶端視窗位置或狀態的通知。

從介面 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 為 true，該新視窗將共享對應於此輸入方法上下文的輸入上下文，以便自動將視窗中的元件事件指派到該輸入方法。此外，使用 setVisible(true) 打開視窗時，輸入上下文將阻止可能的對輸入方法的停用或啟動調用。

如果不再需要已返回的輸入方法視窗，則輸入方法必須調用該視窗上的 Window.dispose。

參數：

title - 視窗標題欄（如果有此標題欄）中顯示的標題。將 null 值看作空字元串 ("")。

attachToInputContext - 是否應共享對應於此輸入方法上下文的輸入上下文

返回：

帶有輸入方法使用的特殊特徵的視窗

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回 true

createInputMethodJFrame

JFrame createInputMethodJFrame(String title,
                               boolean attachToInputContext)

創建輸入方法使用的頂層 Swing JFrame。此視窗預期的行為是：

• 浮動於所有文檔視窗和對話框上方
• 它和它包含的所有元件都不接收焦點
• 該視窗略有裝飾，如減化的無標題拖動區域

不過，對應於這三項的實際行為與平臺有關。

標題可以顯示也可以不顯示，具體取決於所創建視窗的實際型別。

如果 attachToInputContext 為 true，該新視窗將共享對應於此輸入方法上下文的輸入上下文，以便自動將視窗中的元件事件指派到該輸入方法。此外，使用 setVisible(true) 打開視窗時，輸入上下文將阻止可能的對輸入方法的停用或啟動調用。

如果不再需要已返回的輸入方法視窗，則輸入方法必須調用該視窗上的 Window.dispose。

參數：

title - 視窗標題欄（如果有此標題欄）中顯示的標題。將 null 值看作空字元串 ("")。

attachToInputContext - 是否應共享對應於此輸入方法上下文的輸入上下文

返回：

帶有輸入方法使用的特殊特徵的 JFrame

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回 true

從以下版本開始：

1.4

enableClientWindowNotification

void enableClientWindowNotification(InputMethod inputMethod,
                                    boolean enable)

啟用或禁用指定輸入方法的當前客戶端視窗位置或狀態的通知。啟用通知時，按方法規範中描述的那樣調用該輸入方法的 notifyClientWindowChange 方法。釋放掉輸入方法後將自動禁用通知。

參數：

inputMethod - 已啟用或已禁用通知的輸入方法

enable - true 表示啟用，false 表示禁用