QInputContext Class Reference · PyQt4 中文文檔

# QInputContext Class Reference ## [[QtGui](index.htm) module] 該QInputContext類抽象的輸入法相關的數據和作曲的狀態。[More...](#details) 繼承[QObject](qobject.html)。 ### Types * `enum StandardFormat { PreeditFormat, SelectionFormat }` ### Methods * `__init__ (self, QObject?parent?=?None)` * `list-of-QAction actions (self)` * `bool filterEvent (self, QEvent?event)` * `QWidget focusWidget (self)` * `QFont font (self)` * `QString identifierName (self)` * `bool isComposing (self)` * `QString language (self)` * `mouseHandler (self, int?x, QMouseEvent?event)` * `reset (self)` * `sendEvent (self, QInputMethodEvent?event)` * `setFocusWidget (self, QWidget?w)` * `QTextFormat standardFormat (self, StandardFormat?s)` * `update (self)` * `widgetDestroyed (self, QWidget?w)` * * * ## Detailed Description 該QInputContext類抽象的輸入法相關的數據和作曲的狀態。輸入法是負責輸入無法通過簡單的鍵盤映射輸入復雜的文本。它可以轉換輸入事件（通常為關鍵事件）的序列轉換成通過輸入法的具體轉換過程的文本字符串。該類進程的廣泛，從簡單的有限狀態機的復雜文本翻譯器，水池與文本編輯功能的文本的一整段進行語法和語義分析。抽象如此不同的輸入法，具體中間信息， Qt的提供QInputContext作為基類。這個概念是眾所周知的輸入法域“輸入上下文” 。一個輸入上下文的文本控件在響應需求創建的。它確保了一個輸入上下文制備用于輸入到文本構件之前的輸入方法。屬于一個單一的輸入法多輸入上下文可以同時共存。假設多窗口的文本編輯器。窗口A和B的每個文本控件持有不同QInputContext實例，它包含不同的狀態信息，如部分組成的文本。 ### Groups of Functions | Context | Functions | | --- | --- | | Receiving information | [x11FilterEvent](qinputcontext.html#x11FilterEvent)(), [filterEvent](qinputcontext.html#filterEvent)(), [mouseHandler](qinputcontext.html#mouseHandler)() | | Sending back composed text | [sendEvent](qinputcontext.html#sendEvent)() | | State change notification | [setFocusWidget](qinputcontext.html#setFocusWidget)(), [reset](qinputcontext.html#reset)() | | Context information | [identifierName](qinputcontext.html#identifierName)(), [language](qinputcontext.html#language)(), [font](qinputcontext.html#font)(), [isComposing](qinputcontext.html#isComposing)() | ### Licensing Information 版權所有（C ）2003-2004 immodule Qt的項目。保留所有權利。該文件是寫在自己的許可以促進諾基亞公司和/或其附屬公司（ - IES ）。你可以使用這個文件在你的Qt許可。下面的描述是從原來的文件頭復制。聯系immodule-qt@freedesktop.org如果是這種許可的條件不明確給你。 * * * ## Type Documentation ``` QInputContext.StandardFormat ``` | Constant | Value | Description | | --- | --- | --- | | `QInputContext.PreeditFormat` | `0` | 預編輯文本。 | | `QInputContext.SelectionFormat` | `1` | 選擇文本。 | **See also** [standardFormat](qinputcontext.html#standardFormat)（）。 * * * ## Method Documentation ``` QInputContext.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個輸入上下文與給定_parent_。 ``` list-of-QAction QInputContext.actions (self) ``` 這是為Qt 4的初步接口。 ``` bool QInputContext.filterEvent (self, QEvent?event) ``` 此功能可以在子類中重新實現過濾輸入事件。返回True，如果_event_已被消耗。否則，未過濾的_event_將被轉發到微件作為普通的方式。雖然輸入事件已接受（）和忽略（）方法，讓它不變。 _event_目前僅限于這些類型的事件： * CloseSoftwareInputPanel * KeyPress * KeyRelease * MouseButtonDblClick * MouseButtonPress * MouseButtonRelease * MouseMove * RequestSoftwareInputPanel 但有些輸入法相關的事件，如[QWheelEvent](qwheelevent.html) or [QTabletEvent](qtabletevent.html)可能在將來增加。濾波機會總是提供給輸入上下文盡快。它必須發生的任何其他關鍵事件消費者如eventfilters和加速器之前因為一些輸入法需要相當不同的按鍵組合和順序。它常與加速器等沖突，所以我們必須給輸入上下文濾波機會首先要保證所有的輸入法正常工作，而不管應用程序設計。普通輸入法需要離散關鍵事件才能正常工作，所以Qt的鍵壓縮始終是任何輸入上下文停用。 **See also** [QKeyEvent](qkeyevent.html)和[x11FilterEvent](qinputcontext.html#x11FilterEvent)（）。 ``` QWidget QInputContext.focusWidget (self) ``` [ 返回具有輸入焦點此輸入上下文的部件。返回值可能不同于holderWidget （）如果輸入上下文幾個文本組件之間共享。 **Warning:**為了保證平臺的獨立性，并支持小部件的靈活配置，普通的輸入方法不應該直接調用此函數。 ](qwidget.html) [**See also**](qwidget.html) [setFocusWidget](qinputcontext.html#setFocusWidget)（）。 ``` QFont QInputContext.font (self) ``` [ 返回當前輸入小部件的字體 ``` QString QInputContext.identifierName (self) ``` 這種方法是抽象的，應在任何子類中重新實現。該功能必須在任何子類中實現，返回輸入法的識別名稱。 ](qfont.html) [返回值是確定并指定輸入法的輸入法切換機制等名稱。該名稱必須一致](qfont.html)[QInputContextPlugin.keys](index.htm#keys)（）。該名稱必須只包含ASCII字符。有兩個不同的名字，在該輸入法域不同的責任。這個函數返回其中之一。另一名被稱為是代表名稱為終端用戶出現在菜單等等“顯示名稱” 。 **See also** [QInputContextPlugin.keys](index.htm#keys)（）和[QInputContextPlugin.displayName](index.htm#displayName)（）。 ``` bool QInputContext.isComposing (self) ``` 這種方法是抽象的，應在任何子類中重新實現。該函數表示InputMethodStart事件是否已被發送到當前焦點控件。它是確保輸入上下文可以發送InputMethodCompose或InputMethodEnd安全事件，如果這個函數返回True 。該狀態會自動被通過跟蹤[sendEvent](qinputcontext.html#sendEvent)（）。 **See also** [sendEvent](qinputcontext.html#sendEvent)（）。 ``` QString QInputContext.language (self) ``` 這種方法是抽象的，應在任何子類中重新實現。該功能必須在任何子類中實現，返回的輸入上下文的語言代碼（如“ zh_CN的” ， “ ZH_TW ” ， “了zh_HK ” ， “ JA ” ， “KO” ， ... ）。如果輸入的情況下能處理多種語言，返回當前使用的之一。該名稱必須與QInputContextPlugin.language （）是一致的。這些信息將被用于語言標記功能[QInputMethodEvent](qinputmethodevent.html)。這是需要正確區分統一漢字。它使正確的字體和字符代碼處理。假設CJK- awared多種語言的網頁瀏覽器（自動修改字體中日韓混合文本）和XML編輯器（即自動插入郎ATTR ）。 ``` QInputContext.mouseHandler (self, int?x, QMouseEvent?event) ``` 此功能可重新實現在子類中處理鼠標按下，釋放，雙擊，然后將預編輯文本中的事件。您可以使用該功能來實現鼠標為導向的用戶界面，例如文本或選擇彈出菜單中選擇候選人。該_x_參數是所發送的InputMethodCompose事件串中的偏移量。的改變邊界_x_確保為預編輯字符串的字符邊界準確。該_event_參數是被送到編輯器插件的事件。事件類型是[QEvent.MouseButtonPress](qevent.html#Type-enum)，[QEvent.MouseButtonRelease](qevent.html#Type-enum)，[QEvent.MouseButtonDblClick](qevent.html#Type-enum) or [QEvent.MouseMove](qevent.html#Type-enum)。本次活動的按鈕和狀態顯示已執行的一種操作。 ``` QInputContext.reset (self) ``` 這種方法是抽象的，應在任何子類中重新實現。此功能可重新實現在子類中重新設置輸入法的狀態。此功能稱為由幾個部件復位輸入狀態。例如，一個文本組件插入文字，使小工具準備好接受一個文本之前調用這個函數。默認的實現是足夠簡單的輸入法。你可以重載這個函數來在復雜的輸入法復位外部的輸入法引擎。在該情況下，調用QInputContext.reset （），以確保正確的端接輸入的。在復位（）的重新實現，您不能發送任何[QInputMethodEvent](qinputmethodevent.html)含預編輯文本。您只能提交字符串和屬性，否則，你的風險斷裂輸入狀態的一致性。 ``` QInputContext.sendEvent (self, QInputMethodEvent?event) ``` 通過發送指定的輸入法事件_event_以目前的重點部件。的實現[QInputContext](qinputcontext.html)應該調用此方法來發送生成的輸入法事件，而不是[QApplication.sendEvent](qcoreapplication.html#sendEvent)（），因為事件可能要被分派到一些平臺上的不同應用程序。一些復雜的輸入法路線的處理到幾個子上下文（例如，使語言切換）。考慮到這一點，[QInputContext](qinputcontext.html)將檢查如果父對象是[QInputContext](qinputcontext.html)。如果是的話，它會調用父母的SendEvent （）實現，而不是直接發送該事件。 **See also** [QInputMethodEvent](qinputmethodevent.html)。 ``` QInputContext.setFocusWidget (self, QWidget?w) ``` 設置_widget_具有輸入焦點此輸入上下文。 **Warning:**普通的輸入法不能直接調用此函數。 **See also** [focusWidget](qinputcontext.html#focusWidget)（）。 ``` QTextFormat QInputContext.standardFormat (self, StandardFormat?s) ``` [](qtextformat.html) [返回](qtextformat.html)[QTextFormat](qtextformat.html)對象，指定組件的格式_s_。 ``` QInputContext.update (self) ``` 這個虛函數被調用時，在焦點部件的狀態發生了變化。[QInputContext](qinputcontext.html)然后可以使用[QWidget.inputMethodQuery](qwidget.html#inputMethodQuery)（）來查詢widget的新狀態。 ``` QInputContext.widgetDestroyed (self, QWidget?w) ``` 指定當該虛擬函數調用_widget_被破壞。該_widget_是安裝在此輸入上下文上的一個小部件。