Widget 和图形视图中的手势

Qt 包括手势编程框架，拥有从独立于所用输方法的一系列事件形成手势的能力。手势可以是特定鼠标运动，触摸屏动作，或来自某些其它源的一系列事件。输入的性质、手势的解释及获取动作由开发者抉择。

概述

QGesture 是 Qt 手势框架中心类，提供用户履行手势有关信息的容器。 QGesture 暴露了赋予所有手势一般公共信息的特性，且可以扩展这些以提供特定额外手势信息。常见的平移、捏合和轻扫手势由专用类表示： QPanGesture , QPinchGesture and QSwipeGesture .

开发者还可以实现新手势通过子类化并扩展 QGestureRecognizer 类。添加支持新手势涉及实现从输入事件识别手势的代码。这的描述在创建自己的手势识别器章节。

在 Widget 中使用标准手势

可以启用手势为实例化的 QWidget and QGraphicsObject 子类。接受手势输入的对象在整个文档编制被称为 目标对象 .

要启用目标对象手势，调用其 QWidget::grabGesture () 或 QGraphicsObject::grabGesture () 函数采用自变量描述要求的手势类型。标准类型的定义是通过 Qt::GestureType 枚举且包括很多常用手势。

for (Qt::GestureType gesture : gestures)
    grabGesture(gesture);

以上代码，手势是在目标对象本身的构造函数中设置的。

处理事件

当用户履行手势时， QGestureEvent 事件会被交付给目标对象，且可以处理这些通过重实现 QWidget::event () 处理程序函数为 Widget 或 QGraphicsItem::sceneEvent () 为图形对象。

由于一个目标对象可以订阅多种手势类型， QGestureEvent 可以包含多个 QGesture ，指示几个手势同时活动是可能的。然后由 Widget 确定如何处理这些手势并选择，若取消一些手势代之其它手势。

每个 QGesture 包含于 QGestureEvent 对象可以单独或全部一起 accepted() 或 ignored()。此外，可以查询单个 QGesture 数据对象 (状态) 使用几个 Getter。

事件处理的标准程序

A QGesture 默认是接受的，当它到达 Widget 时。不管怎样，好的实践是始终明确接受 (或拒绝) 手势。一般规则是，若接受手势，就会使用它。若忽略，就是对它不感兴趣。忽略手势可能意味着，会将它提供给另一目标对象 (或者它将被取消)。

每个 QGesture 会经历几种状态；有改变状态的良好定义方式，通常，用户输入是状态变化的原因 (例如：通过启动和停止交互)，但 Widget 也可能导致状态改变。

首先，特定 QGesture 被交付给 Widget 或图形项，它会在 Qt::GestureStarted 状态。此时处理手势的方式，会影响稍后是否可以与之交互。

接受手势意味着 Widget 作用于手势，且手势随后具有 Qt::GestureUpdatedstate。
忽略手势将意味着不会再提供手势。还会将它提供给父级 Widget 或项。
调用手势的 setGestureCancelPolicy() 当其处于启动状态时，且接受还会导致其它手势被取消。

使用 QGesture::CancelAllInContext 来取消手势将导致所有手势被取消，在任何状态下都会被取消，除非明确接受它们。这意味着，将取消子级的活动手势。也意味着，手势的交付是在同一 QGestureEvent 会被取消若 Widget 忽略它们。这是可以过滤掉所有手势的有用方式，除感兴趣的手势外。

事件处理范例

为方便起见，图像手势范例重实现一般 event () 处理程序函数并将手势事件委托给专用 gestureEvent() 函数：

bool ImageWidget::event(QEvent *event)
{
    if (event->type() == QEvent::Gesture)
        return gestureEvent(static_cast<QGestureEvent*>(event));
    return QWidget::event(event);
}

可以单独审查交付给目标对象的手势事件，并适当处理：

bool ImageWidget::gestureEvent(QGestureEvent *event)
{
    qCDebug(lcExample) << "gestureEvent():" << event;
    if (QGesture *swipe = event->gesture(Qt::SwipeGesture))
        swipeTriggered(static_cast<QSwipeGesture *>(swipe));
    else if (QGesture *pan = event->gesture(Qt::PanGesture))
        panTriggered(static_cast<QPanGesture *>(pan));
    if (QGesture *pinch = event->gesture(Qt::PinchGesture))
        pinchTriggered(static_cast<QPinchGesture *>(pinch));
    return true;
}

手势响应问题只需获得 QGesture 交付对象在 QGestureEvent 被发送给目标对象并审查它包含的信息。

void ImageWidget::swipeTriggered(QSwipeGesture *gesture)
{
    if (gesture->state() == Qt::GestureFinished) {
        if (gesture->horizontalDirection() == QSwipeGesture::Left
            || gesture->verticalDirection() == QSwipeGesture::Up) {
            qCDebug(lcExample) << "swipeTriggered(): swipe to previous";
            goPrevImage();
        } else {
            qCDebug(lcExample) << "swipeTriggered(): swipe to next";
            goNextImage();
        }
        update();
    }
}

这里，我们审查用户轻扫 Widget 的方向并相应修改其内容。

创建自己的手势识别器

添加支持新手势涉及创建并注册新手势识别器。从属手势识别过程，还可能涉及创建新手势对象。

要创建新识别器，需要子类化 QGestureRecognizer 以创建自定义识别器类。有 1 个虚拟函数必须重实现，和其它 2 个可以按要求重实现。

过滤输入事件

The recognize () function must be reimplemented. This function handles and filters the incoming input events for the target objects and determines whether or not they correspond to the gesture the recognizer is looking for.

尽管手势识别逻辑是在此函数中实现的，可能使用状态机基于 Qt::GestureState 枚举，可以将识别过程状态的有关持久信息存储在 QGesture 供给对象。

您的 recognize () 函数必须返回的值为 QGestureRecognizer::Result 指示给定手势和目标对象的识别状态。这确定是否有将手势事件交付给目标对象。

自定义手势

若要选择表示手势通过自定义 QGesture 子类，将需要重实现 create () function to construct instances of your gesture class instead of standard QGesture 实例。另外，可能想要使用标准 QGesture 实例，但要对它们添加额外动态特性以表达想要处理手势的特定细节。

重置手势

若取消手势时使用需要重置 (或其它特殊处理) 的自定义手势对象，需要重实现 reset () function to perform these special tasks.

注意， QGesture 对象只创建一次对于目标对象和手势类型的每个组合，且会重用它们每当用户试图对目标对象履行相同手势类型时。因此，会很有用重实现 reset () function to clean up after each previous attempt at recognizing a gesture.

使用新的手势识别器

要使用手势识别器，构建实例化的 QGestureRecognizer 子类，并将它注册到应用程序采用 QGestureRecognizer::registerRecognizer ()。可以移除给定类型的手势识别器采用 QGestureRecognizer::unregisterRecognizer ().