QGestureRecognizer Class

成员函数文档

QGestureRecognizer::QGestureRecognizer()

创建一个新的手势识别器对象。

[virtual noexcept] QGestureRecognizer::~QGestureRecognizer()

销毁手势识别器。

[virtual] QGesture *QGestureRecognizer::create(QObject *target)

该函数由 Qt XML 调用，用于为给定的target （QWidget 或QGraphicsObject ）创建一个新的QGesture 对象。

如有必要，请重写此函数以创建一个自定义的、从QGesture 派生的手势对象。

QApplication 将获得所创建的手势对象的所有权。

[pure virtual] QGestureRecognizer::Result QGestureRecognizer::recognize(QGesture *gesture, QObject *watched, QEvent *event)

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

该函数由框架调用，以便识别器能够过滤分发到其正在监视的QWidget 或QGraphicsObject 实例上的输入事件。

结果反映了手势已被识别的程度。gesture 对象的状态将根据该结果进行设置。

另请参阅 QGestureRecognizer::Result 。

[static] Qt::GestureType QGestureRecognizer::registerRecognizer(QGestureRecognizer *recognizer)

将给定的recognizer 注册到手势框架中，并返回其对应的手势ID。

QApplication 该函数将recognizer 设为所有者，并返回与其关联的手势类型ID。对于处理自定义QGesture 对象的手势识别器（即在QGesture::gestureType()函数中返回Qt::CustomGesture 的识别器），其返回值是一个生成的手势ID，且该ID的Qt::CustomGesture 标志已被设置。

另请参阅 unregisterRecognizer()、QGestureRecognizer::create() 以及QGesture 。

[virtual] void QGestureRecognizer::reset(QGesture *gesture)

该函数由 Qt XML 调用，用于重置指定的gesture 。

请重写此函数，以实现自定义QGesture 对象的额外要求。如果您实现了自定义的QGesture ，且该对象的属性在手势重置时需要特殊处理，则可能需要重写此函数。

[static] void QGestureRecognizer::unregisterRecognizer(Qt::GestureType type)

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

另请参阅 registerRecognizer()。