QGestureRecognizer Class Reference

[QtGui module]

该QGestureRecognizer类提供了手势识别的基础设施。More…

Types

• class **[Result](docs_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对象和发送到监视输入事件QWidget和QGraphicsObject子类。 QGestureRecognizer是实现自定义手势的基类。

开发人员只需要提供手势识别的标准手势不需要直接使用这个类。实例将在幕后由框架创建。

手势使用手势在你的应用程序在处理Qt和信息的概述，请参阅Gestures Programming文档。

Recognizing Gestures

识别手势的过程涉及发送给特定对象的过滤输入事件，并修改相关QGesture对象以包含有关用户的输入相关的信息。

创建手势时，框架调用create（）来处理的特定实例的用户输入QWidget or QGraphicsObject子类。一QGesture对象为被配置为使用手势每个插件或项目创建。

一旦QGesture已经为一个目标对象创建时，手势识别将获得它的活动recognize（ ）处理函数。

当手势被取消，reset（ ）函数被调用，从而使识别器，以更新相应的适当的属性的机会QGesture对象。

Supporting New Gestures

要添加新手势的支持，你需要从QGestureRecognizer派生来创建一个自定义识别器类，构造这个类的一个实例，并与应用程序通过调用它注册QGestureRecognizer.registerRecognizer（ ） 。您也可以继承QGesture创建一个自定义手势类，或依赖动态特性来表达你要处理的姿态具体细节。

您的自定义QGestureRecognizer子类需要重新实现recognize（ ）函数来处理和过滤的传入输入事件QWidget和QGraphicsObject子类。虽然手势识别的逻辑在这个函数的实现，你可以存储在识别过程中的状态持久性信息QGesture对象提供。该recognize（ ）函数必须返回一个值QGestureRecognizer.Result这说明，对于一个给定的姿态和目标物体识别的状态。这决定了一个手势事件是否将被传递到的目标对象。

如果您选择自定义来表示一种姿态QGesture子类，你需要重新实现create（ ）函数来构造你的手势类的实例。同样，您可能需要重新实现reset（ ）函数，如果要特殊处理，当手势被取消您的自定义手势对象需要。

Type Documentation

QGestureRecognizer.ResultFlag

这个枚举变量描述了一个手势识别状态机的当前事件的过滤步骤的结果。

该结果由一个状态值（一个忽略， MayBeGesture ， TriggerGesture ， FinishGesture ， CancelGesture ）和一个可选的提示（ ConsumeEventHint ） 。

结果类型是一个typedef为QFlags\u003cResultFlag\u003e 。它存储ResultFlag值的或组合。

See also QGestureRecognizer.recognize（ ） 。

Method Documentation

QGestureRecognizer.__init__ (self)

构造一个新的手势识别对象。

QGestureRecognizer.__init__ (self, QGestureRecognizer)

QGesture QGestureRecognizer.create (self, QObject target)

这个功能是通过Qt的调用来创建一个新的QGesture对象为给定的target（QWidget or QGraphicsObject） 。

重新实现这个函数来创建一个自定义QGesture衍生的手势对象如有必要。

该应用程序需要创建的手势对象的所有权。

Result QGestureRecognizer.recognize (self, QGesture state, QObject watched, QEvent event)

[

这种方法是抽象的，应在任何子类中重新实现。

处理给定的event为watched对象，更新的状态gesture为所需的对象，并返回一个合适的结果，当前识别步骤。

](docs_index.htm)

这个函数由框架调用，以允许识别器来过滤派往输入事件QWidget or QGraphicsObject情况下，它正在监视。

其结果反映了手势的多已被确认。的状态gesture根据结果对象被设置。

See also QGestureRecognizer.Result。

Qt.GestureType QGestureRecognizer.registerRecognizer (QGestureRecognizer recognizer)

[

该recognizer说法有它的所有权转移给Qt的。

注册给定的recognizer在手势框架，并返回一个手势ID为它。

](docs_qt.html#GestureType-enum)

该应用程序采用的所有权recognizer并返回与它相关联的手势类型ID。对于手势识别的处理自定义QGesture对象（即，那些回报Qt.CustomGesture在QGesture.gestureType（ ）函数）的返回值是与生成的手势识别码Qt.CustomGesture标志设置。

See also unregisterRecognizer（ ）QGestureRecognizer.create（）和QGesture。

QGestureRecognizer.reset (self, QGesture state)

调用此函数由框架来重置一个给定的gesture。

重新实现这个函数来实现自定义的附加要求QGesture对象。如果你实现一个自定义的，这可能是必要的QGesture其性质需要当手势被复位特殊处理。

QGestureRecognizer.unregisterRecognizer (Qt.GestureType type)

取消注册所有手势指定的识别type。

See also registerRecognizer（ ） 。