# QGestureRecognizer Class Reference ## [[QtGui](index.htm) module] 該QGestureRecognizer類提供了手勢識別的基礎設施。[More...](#details) ### Types * `class **[Result](index.htm)**` * `enum ResultFlag { Ignore, MayBeGesture, TriggerGesture, FinishGesture, CancelGesture, ConsumeEventHint }` ### Methods * `__init__ (self)` * `__init__ (self, QGestureRecognizer)` * `QGesture create (self, QObject?target)` * `Result recognize (self, QGesture?state, QObject?watched, QEvent?event)` * `reset (self, QGesture?state)` ### Static Methods * `Qt.GestureType registerRecognizer (QGestureRecognizer?recognizer)` * `unregisterRecognizer (Qt.GestureType?type)` * * * ## Detailed Description 該QGestureRecognizer類提供了手勢識別的基礎設施。 手勢識別器負責創建和管理[QGesture](qgesture.html)對象和發送到監視輸入事件[QWidget](qwidget.html)和[QGraphicsObject](qgraphicsobject.html)子類。 QGestureRecognizer是實現自定義手勢的基類。 開發人員只需要提供手勢識別的標準手勢不需要直接使用這個類。實例將在幕后由框架創建。 手勢使用手勢在你的應用程序在處理Qt和信息的概述，請參閱[Gestures Programming](index.htm)文檔。 ### Recognizing Gestures 識別手勢的過程涉及發送給特定對象的過濾輸入事件，并修改相關[QGesture](qgesture.html)對象以包含有關用戶的輸入相關的信息。 創建手勢時，框架調用[create](qgesturerecognizer.html#create)（）來處理的特定實例的用戶輸入[QWidget](qwidget.html) or [QGraphicsObject](qgraphicsobject.html)子類。一[QGesture](qgesture.html)對象為被配置為使用手勢每個插件或項目創建。 一旦[QGesture](qgesture.html)已經為一個目標對象創建時，手勢識別將獲得它的活動[recognize](qgesturerecognizer.html#recognize)（ ）處理函數。 當手勢被取消，[reset](qgesturerecognizer.html#reset)（ ）函數被調用，從而使識別器，以更新相應的適當的屬性的機會[QGesture](qgesture.html)對象。 ### Supporting New Gestures 要添加新手勢的支持，你需要從QGestureRecognizer派生來創建一個自定義識別器類，構造這個類的一個實例，并與應用程序通過調用它注冊[QGestureRecognizer.registerRecognizer](qgesturerecognizer.html#registerRecognizer)（ ） 。您也可以繼承[QGesture](qgesture.html)創建一個自定義手勢類，或依賴動態特性來表達你要處理的姿態具體細節。 您的自定義QGestureRecognizer子類需要重新實現[recognize](qgesturerecognizer.html#recognize)（ ）函數來處理和過濾的傳入輸入事件[QWidget](qwidget.html)和[QGraphicsObject](qgraphicsobject.html)子類。雖然手勢識別的邏輯在這個函數的實現，你可以存儲在識別過程中的狀態持久性信息[QGesture](qgesture.html)對象提供。該[recognize](qgesturerecognizer.html#recognize)（ ）函數必須返回一個值[QGestureRecognizer.Result](qgesturerecognizer.html#ResultFlag-enum)這說明，對于一個給定的姿態和目標物體識別的狀態。這決定了一個手勢事件是否將被傳遞到的目標對象。 如果您選擇自定義來表示一種姿態[QGesture](qgesture.html)子類，你需要重新實現[create](qgesturerecognizer.html#create)（ ）函數來構造你的手勢類的實例。同樣，您可能需要重新實現[reset](qgesturerecognizer.html#reset)（ ）函數，如果要特殊處理，當手勢被取消您的自定義手勢對象需要。 * * * ## Type Documentation ``` QGestureRecognizer.ResultFlag ``` 這個枚舉變量描述了一個手勢識別狀態機的當前事件的過濾步驟的結果。 該結果由一個狀態值（一個忽略， MayBeGesture ， TriggerGesture ， FinishGesture ， CancelGesture ）和一個可選的提示（ ConsumeEventHint ） 。 | Constant | Value | Description | | --- | --- | --- | | `QGestureRecognizer.Ignore` | `0x0001` | 該事件不改變識別器的狀態。 | | `QGestureRecognizer.MayBeGesture` | `0x0002` | 事件改變識別器的內部狀態，但目前還不清楚，如果它是一個手勢或沒有。該識別需要過濾更多的事件來決定。在MayBeGesture狀態手勢識別，如果他們需要很長時間才能識別手勢可能會自動復位。 | | `QGestureRecognizer.TriggerGesture` | `0x0004` | 姿態已被觸發并且相應[QGesture](qgesture.html)對象將被傳遞到的目標，作為一個部分[QGestureEvent](qgestureevent.html)。 | | `QGestureRecognizer.FinishGesture` | `0x0008` | 手勢已經成功完成，并適當[QGesture](qgesture.html)對象將被傳遞到的目標，作為一個部分[QGestureEvent](qgestureevent.html)。 | | `QGestureRecognizer.CancelGesture` | `0x0010` | 事件清楚表明，它不是一種姿態。如果手勢識別是GestureTriggered狀態之前，則該手勢被取消，相應的[QGesture](qgesture.html)對象將被傳遞到的目標，作為一個部分[QGestureEvent](qgestureevent.html)。 | | `QGestureRecognizer.ConsumeEventHint` | `0x0100` | 這提示指定的手勢框架應該消耗的過濾事件，并沒有提供它的接收器。 | 結果類型是一個typedef為[QFlags](index.htm)\u003cResultFlag\u003e 。它存儲ResultFlag值的或組合。 **See also** [QGestureRecognizer.recognize](qgesturerecognizer.html#recognize)（ ） 。 * * * ## Method Documentation ``` QGestureRecognizer.__init__ (self) ``` 構造一個新的手勢識別對象。 ``` QGestureRecognizer.__init__ (self, QGestureRecognizer) ``` ``` QGesture QGestureRecognizer.create (self, QObject?target) ``` [](qgesture.html) [這個功能是通過Qt的調用來創建一個新的](qgesture.html)[QGesture](qgesture.html)對象為給定的_target_（[QWidget](qwidget.html) or [QGraphicsObject](qgraphicsobject.html)） 。 重新實現這個函數來創建一個自定義[QGesture](qgesture.html)衍生的手勢對象如有必要。 該應用程序需要創建的手勢對象的所有權。 ``` Result QGestureRecognizer.recognize (self, QGesture?state, QObject?watched, QEvent?event) ``` [ 這種方法是抽象的，應在任何子類中重新實現。 處理給定的_event_為_watched_對象，更新的狀態_gesture_為所需的對象，并返回一個合適的結果，當前識別步驟。 ](index.htm) [這個函數由框架調用，以允許識別器來過濾派往輸入事件](index.htm)[QWidget](qwidget.html) or [QGraphicsObject](qgraphicsobject.html)情況下，它正在監視。 其結果反映了手勢的多已被確認。的狀態_gesture_根據結果對象被設置。 **See also** [QGestureRecognizer.Result](qgesturerecognizer.html#ResultFlag-enum)。 ``` Qt.GestureType QGestureRecognizer.registerRecognizer (QGestureRecognizer?recognizer) ``` [ 該_recognizer_說法有它的所有權轉移給Qt的。 注冊給定的_recognizer_在手勢框架，并返回一個手勢ID為它。 ](qt.html#GestureType-enum) [該應用程序采用的所有權_recognizer_并返回與它相關聯的手勢類型ID。對于手勢識別的處理自定義](qt.html#GestureType-enum)[QGesture](qgesture.html)對象（即，那些回報[Qt.CustomGesture](qt.html#GestureType-enum)在[QGesture.gestureType](qgesture.html#gestureType-prop)（ ）函數）的返回值是與生成的手勢識別碼[Qt.CustomGesture](qt.html#GestureType-enum)標志設置。 **See also** [unregisterRecognizer](qgesturerecognizer.html#unregisterRecognizer)（ ）[QGestureRecognizer.create](qgesturerecognizer.html#create)（）和[QGesture](qgesture.html)。 ``` QGestureRecognizer.reset (self, QGesture?state) ``` 調用此函數由框架來重置一個給定的_gesture_。 重新實現這個函數來實現自定義的附加要求[QGesture](qgesture.html)對象。如果你實現一個自定義的，這可能是必要的[QGesture](qgesture.html)其性質需要當手勢被復位特殊處理。 ``` QGestureRecognizer.unregisterRecognizer (Qt.GestureType?type) ``` 取消注冊所有手勢指定的識別_type_。 **See also** [registerRecognizer](qgesturerecognizer.html#registerRecognizer)（ ） 。