Modified gesture events propagation.

By default if the gesture is ignored, only gestures in the started state
are propagated, and accepting a gesture in the started state adds an
implicit grab meaning all the following events in the gesture sequence
will be delivered to that widget. This is similar to the way QTouchEvent
is propagated.

Also added a hint, which specifies if gestures in any state can be
propagated to the widget which has enabled the hint.

Reviewed-by: Thomas Zander

2 files changed, 24 insertions, 6 deletions

diff --git a/src/corelib/global/qnamespace.h b/src/corelib/global/qnamespace.h
index aeaca54..561ffc1 100644
--- a/src/corelib/global/qnamespace.h
+++ b/src/corelib/global/qnamespace.h
@@ -1715,14 +1715,19 @@ public:
         LastGestureType   = ~0u
     };
 
-    enum GestureContext
+    enum GestureContextFlag
     {
         WidgetGesture             = 0,
         WidgetWithChildrenGesture = 3,
 
-        ItemGesture                  = WidgetGesture,
-        ItemWithChildrenGesture      = WidgetWithChildrenGesture
+        ItemGesture               = WidgetGesture,
+        ItemWithChildrenGesture   = WidgetWithChildrenGesture,
+
+        GestureContext_Mask       = 0x00ff,
+        AcceptPartialGesturesHint = 0x0100,
+        GestureContextHint_Mask   = 0xff00
     };
+    Q_DECLARE_FLAGS(GestureContext, GestureContextFlag)
 
     enum NavigationMode
     {
@@ -1757,6 +1762,7 @@ Q_DECLARE_OPERATORS_FOR_FLAGS(Qt::MatchFlags)
 Q_DECLARE_OPERATORS_FOR_FLAGS(Qt::TextInteractionFlags)
 Q_DECLARE_OPERATORS_FOR_FLAGS(Qt::InputMethodHints)
 Q_DECLARE_OPERATORS_FOR_FLAGS(Qt::TouchPointStates)
+Q_DECLARE_OPERATORS_FOR_FLAGS(Qt::GestureContext)
 
 typedef bool (*qInternalCallback)(void **);
 
diff --git a/src/corelib/global/qnamespace.qdoc b/src/corelib/global/qnamespace.qdoc
index 3fcbe57..f2a8882 100644
--- a/src/corelib/global/qnamespace.qdoc
+++ b/src/corelib/global/qnamespace.qdoc
@@ -2917,11 +2917,11 @@
     QApplication::registerGestureRecognizer() function which generates a custom gesture ID
     in the range of values from CustomGesture to LastGestureType.
 
-    \sa QGesture, QWidget::grabGesture()
+    \sa QGesture, QWidget::grabGesture(), QGraphicsObject::grabGesture()
 */
 
 /*!
-    \enum Qt::GestureContext
+    \enum Qt::GestureContextFlag
     \since 4.6
 
     This enum type describes the context of a gesture.
@@ -2937,7 +2937,19 @@
     \value ItemWithChildrenGesture Gestures can start on the item or over
     any of its children.
 
-    \sa QWidget::grabGesture()
+    \value AcceptPartialGesturesHint Allows any ignored gesture events to be
+    propagated to parent widgets which have specified this hint. By default
+    only gestures that are in the Qt::GestureStarted state are propagated and
+    the widget only gets the full gesture sequence starting with a gesture in
+    the Qt::GestureStarted state and ending with a gesture in the
+    Qt::GestureFinished or Qt::GestureCanceled states.
+
+    \value GestureContext_Mask A mask for extracting the context type of the
+    context flags.
+    \value GestureContextHint_Mask A mask for extracting additional hints for
+    the context.
+
+    \sa QWidget::grabGesture(), QGraphicsObject::grabGesture()
 */
 
 /*!