[gtk+] Add symbolic constants for event emission control

[Emmanuele Bassi <ebassi src gnome org>]

commit c62a1fd522e5e1ffe3ae3b40f83bcc78e4b00a81
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Tue Oct 5 14:07:32 2010 +0100

    Add symbolic constants for event emission control
    
    Similar to https://bugzilla.gnome.org/show_bug.cgi?id=631413 in GLib,
    GTK+ should have symbolic constants for controlling the event handling
    instead of a mere boolean value.
    
    The GDK_EVENT_PROPAGATE and GDK_EVENT_STOP constants map to FALSE and
    TRUE respectively.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=631414

 docs/reference/gdk/gdk3-sections.txt |    2 ++
 gdk/gdkevents.h                      |   19 +++++++++++++++++++
 2 files changed, 21 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/gdk/gdk3-sections.txt b/docs/reference/gdk/gdk3-sections.txt
index d393f76..d5deb42 100644
--- a/docs/reference/gdk/gdk3-sections.txt
+++ b/docs/reference/gdk/gdk3-sections.txt
@@ -757,6 +757,8 @@ GdkEventMask
 GDK_CURRENT_TIME
 GDK_PRIORITY_EVENTS
 GDK_PRIORITY_REDRAW
+GDK_EVENT_PROPAGATE
+GDK_EVENT_STOP
 
 <SUBSECTION>
 gdk_events_pending
diff --git a/gdk/gdkevents.h b/gdk/gdkevents.h
index a1baac1..d8a1f76 100644
--- a/gdk/gdkevents.h
+++ b/gdk/gdkevents.h
@@ -74,6 +74,25 @@ G_BEGIN_DECLS
  */
 #define GDK_PRIORITY_REDRAW     (G_PRIORITY_HIGH_IDLE + 20)
 
+/**
+ * GDK_EVENT_PROPAGATE:
+ *
+ * Use this macro as the return value for continuing the propagation of
+ * an event handler.
+ *
+ * Since: 3.4
+ */
+#define GDK_EVENT_PROPAGATE     (FALSE)
+
+/**
+ * GDK_EVENT_STOP:
+ *
+ * Use this macro as the return value for stopping the propagation of
+ * an event handler.
+ *
+ * Since: 3.4
+ */
+#define GDK_EVENT_STOP          (TRUE)
 
 typedef struct _GdkEventAny	    GdkEventAny;
 typedef struct _GdkEventExpose	    GdkEventExpose;