Qt之深入理解gesture

素颜马尾好姑娘i 2022-06-09 08:15 553阅读 0赞

Qt最新的版本4.7中有五个gesture，分别是QPanGesture, QPinchGesture, QSwipeGesture, QTapAndHoldGesture, and QTapGesture， 前三个比较常用，但用过的人仍然很少，很多人人对这个gesture意思感觉也陌生，更不用说对说出他们之间的区别了。这里我先解释一下：  
Pan Gesture就是指一个手指在屏幕上滑动，当滑动距离超过一定大小时就产生了一个Pan Gesture的事件了，如下图所示：  
![pangesture.png][]   
Pinch Gesture就是两指放在屏幕上，靠近或者远离，就像捏东西一样，如下图所示：  
![pinchgesture.png][]   
Swipe Gesture就是一个手指在屏幕上沿着一个固定的方向滑动，滑动一段距离时就产生了一个Swipe Gesture的事件，如下图所示：  
![swipegesture.png][]   
QTapAndHoldGesture和QTapGesture比较简单这里我就偷个懒不说了，哈哈。  
Gesture是个手势，但是个组合拳，过滤Gesture是消耗很大的，一般来说它要过滤好几个事件，要与你要截获的Gesture对比，看有没有可能 是你要的那个手势，如果所有事件都会做很多无用功，因此只有真的我们需要截获那个gesture时才会让系统帮我们这么做。  
  
我比较喜欢看源码说事，就来看看  
每个gesture都有对应的gesture recognizer(手势识别类)来识别这个gesture，比如QPanGesture，它就有QPanGestureRecognizer。可有了 gesture recognizer，系统就认识你这个gesture了吗？不是，你还要将你的gesture recognizer注册到QGestureManager中，而QGestureManager则统一管理所有的gesture recognizer，系统只要通过QGestureManager就可以来识别相应的gesture。让我们来看看QGestureManager的构 造函数源码：

1.  QGestureManager::QGestureManager(QObject \*parent )
2.      : QObject(parent), state(NotGesture), m\_lastCustomGestureId(0)
3.  \{
4.      qRegisterMetaType<Qt::GestureState>();
5.  
6.  \#if defined(Q\_WS\_MAC)
7.      registerGestureRecognizer(new QMacSwipeGestureRecognizer);
8.      registerGestureRecognizer(new QMacPinchGestureRecognizer);
9.    \#if defined(QT\_MAC\_USE\_COCOA)
10.     registerGestureRecognizer(new QMacPanGestureRecognizer);
11.   \#endif
12. \#else
13.     registerGestureRecognizer(new QPanGestureRecognizer);
14.     registerGestureRecognizer(new QPinchGestureRecognizer);
15.     registerGestureRecognizer(new QSwipeGestureRecognizer);
16.     registerGestureRecognizer(new QTapGestureRecognizer);
17. \#endif
18. \#if defined(Q\_OS\_WIN)
19.   \#if !defined(QT\_NO\_NATIVE\_GESTURES)
20.     if (QApplicationPrivate::HasTouchSupport)
21.         registerGestureRecognizer(new QWinNativePanGestureRecognizer);
22.   \#endif
23. \#else
24.     registerGestureRecognizer(new QTapAndHoldGestureRecognizer);
25. \#endif
26. \}

*复制代码*

上面的代码很简单这里我只简单说说，registerGestureRecognizer就是用来注册gesture recognizer的，刚开始说的五个gesture在这里都注册了。  
我们再了看看registerGestureRecognizer函数：

1.  Qt::GestureType QGestureManager::registerGestureRecognizer(QGestureRecognizer \*recognizer)
2.  \{
3.      //这里也用你的recognizer创建一个你的gesture实例，如果没有创建成功就
4.      //返回Qt::GestureType(0)，表示注册失败
5.      QGesture \*dummy = recognizer->create(0);
6.      if (!dummy) \{
7.          qWarning("QGestureManager::registerGestureRecognizer: "
8.                   "the recognizer fails to create a gesture object, skipping registration.");
9.          return Qt::GestureType(0);
10.     \}
11. 
12.     //Code A
13.     //这里如果发现你的gestureType是CustomGesture则会
14.     //返回Qt::GestureType(Qt::CustomGesture + m\_lastCustomGestureId)
15.     //即在Qt::CustomGesture基础上加一个数字，如果是注册第一个的自定义的gesture，
16.     //这里的m\_lastCustomGestureId就是1，再注册就加2，以此类推
17.     //这里对我们理解自定义gesture很有帮助:)
18.     Qt::GestureType type = dummy->gestureType();
19.     if (type == Qt::CustomGesture) \{
20.         // generate a new custom gesture id
21.         ++m\_lastCustomGestureId;
22.         type = Qt::GestureType(Qt::CustomGesture + m\_lastCustomGestureId);
23.     \}
24.     m\_recognizers.insertMulti(type, recognizer);
25.     delete dummy;
26.     return type;
27. \}

*复制代码*

上 面代码中注释的应该比较全，这里我只就Code A部分说一下，如果我自定义一个gesture时，无需管它的gesture类型，也不用重新实现它的gestureType方法，默认的就是 Qt::CustomGesture，这里的你的gesture类型id你可以通过调用 QGestureRecognizer::registerRecognizer方法的返回值来获得，也可以根据上面的代码在 Qt::CustomGesture基础上加上相应的数字来得到。  
  
说完这些，让我们来看看有关gesture的事件传递的过程：  
当你通过调用QWidget ::grabGesture来截获相应的gesture手势时  
如果你想截获某个手势，你需要调用QWidget::grabGesture方法来截获相应的手势类型，我们来看看QWidget::grabGesture方法源码：

1.  void QWidget::grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags)
2.  \{
3.      Q\_D(QWidget);
4.      //这里先向gestureContext，即手势上下文，插入这个gesture类型
5.      //gestureContext是属于这个widget的QWidgetPrivate的，可见这里的截获事件紧限于这个widget
6.      d->gestureContext.insert(gesture, flags);
7.     // 创建gesture manager，这里用的是单例模式，哈哈
8.      (void)QGestureManager::instance();
9.  \}

*复制代码*

这样之后，当事件最终通过经过QApplication::notify方法处理时，如果发现接受事件的widet有截获gesture时，就会将事件叫给gesture manager来过滤。  
整个过程事件传递如下图所示：  
![gestures.png][]

[pangesture.png]: http://gutenberg.troll.no/4.7/images/pangesture.png
[pinchgesture.png]: http://gutenberg.troll.no/4.7/images/pinchgesture.png
[swipegesture.png]: http://gutenberg.troll.no/4.7/images/swipegesture.png
[gestures.png]: /images/20220609/d35b65c020a94e5eb47919c9a39ce8f5.png