gesture: Add GTK_PHASE_TARGET

This phase is meant to run in the default widget handlers, as opposed
to externally as in the bubble/capture phase. This will be most usually
the expected phase for every controller replacing code in event handlers
in GTK+, just so invocation and triggering order is kept unaltered.

1 files changed, 7 insertions, 3 deletions

diff --git a/gtk/gtkenums.h b/gtk/gtkenums.h
index c2076f5167..d095450784 100644
--- a/gtk/gtkenums.h
+++ b/gtk/gtkenums.h
@@ -1060,8 +1060,11 @@ typedef enum
  *   to the event widget. This option should only be used on containers that
  *   might possibly handle events before their children do.
  * @GTK_PHASE_BUBBLE: Events are delivered in the bubble phase. The bubble
- *   phase happens after the capture phase, runs from the event widget, up to
- *   the toplevel.
+ *   phase happens after the capture phase, and before the default handlers
+ *   are run. This phase runs from the event widget, up to the toplevel.
+ * @GTK_PHASE_TARGET: Events are delivered in the default widget event handlers,
+ *   note that widget implementations must chain up on button, motion, touch and
+ *   grab broken handlers for controllers in this phase to be run.
  *
  * Describes the stage at which events are fed into a #GtkEventController.
  *
@@ -1071,7 +1074,8 @@ typedef enum
 {
   GTK_PHASE_NONE,
   GTK_PHASE_CAPTURE,
-  GTK_PHASE_BUBBLE
+  GTK_PHASE_BUBBLE,
+  GTK_PHASE_TARGET
 } GtkPropagationPhase;
 
 /**