QWSInputMethod類參考

詳細說明

#include <QWSInputMethod> 注意：這個類僅僅在嵌入式環境下有效

一個Qt for Embedded Linux應用程序須要一個服務器應用程序來運行，或者它自身成爲一個服務器應用程序。全部的系統會產生事件，包括鍵盤和鼠標事件，這些事件到達服務器應用程序以後，會被傳送到合適的客戶端。

一個輸入法包括了過濾器和可選的圖形界面，用來過濾服務器和客戶端應用程序之間的輸入事件。

建立自定義的輸入法

爲了實現自定義的輸入法，須要得自QWSInputMethod類，並使用服務器的setCurrentInputMethod()函數來安裝註冊。

當繼承QWSInputMethod時，你能夠從新實現filter()函數來處理來自物理的和虛擬的鍵盤還有鼠標設備的輸入。注意：默認的實現是無能爲力的。使用setInputResolution()函數來控制移位的位數，當過濾鼠標的輸入時，即，當從指針分辨率到屏幕分辨率（使用inputResolutionShift()函數檢索當前的分辨率）。

爲了收到一次輸入法查詢的回覆（使用sendQuery()函數發送），你必須從新實現queryResponse()函數，然而若是你想在預編輯文本處理鼠標事件，mouseHandler()必須從新實現。從新實現updateHandler()函數來處理更新事件包括復位和焦點的變化。UpdateType枚舉描述了各種被輸入法承認的更新事件。

使用輸入法

除了在前面的章節提到的filter(),reset(), queryResponse(), mouseHandler()和 updateHandler()函數，QWSInputMethod提供了幾個其餘的函數來幫助窗口系統來管理已安裝的輸入法。

sendEvent()函數向焦點部件發送給定的事件，然而sendPreeditString()函數發送給定的預編輯文本（封裝事件）。QWSInputMethod也提供了sendCommitString()方便的函數用來發送封裝的給定的提交字符串到當前的焦點部件，sendMouseEvent()函數發送給定的鼠標事件。

最後，QWSInputMethod類提供sendQuery()函數發送輸入法查詢。

updateHandler()

處理更新事件，包括復位和焦點的變化，更新事件由給定的type指定，是一個UpdateType枚舉值。

請注意，這個函數從新實現必須調用基實現，它自己不處理的全部案件。