[gtk+/touch-for-3.4-2: 5/44] gdk: Add GdkEventSequence

[Matthias Clasen <matthiasc src gnome org>]

commit 73fc7c7fe512afc85295db9c6e5c34f5d6b21747
Author: Carlos Garnacho <carlosg gnome org>
Date:   Tue Mar 1 08:36:54 2011 +0100

    gdk: Add GdkEventSequence
    
    GdkEventSequence is an opaque pointer type that is used
    to identify sequences of touch events that belong together.

 docs/reference/gdk/gdk3-sections.txt |    2 ++
 gdk/gdk.symbols                      |    1 +
 gdk/gdkevents.c                      |   21 +++++++++++++++++++++
 gdk/gdkevents.h                      |    4 ++++
 4 files changed, 28 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/gdk/gdk3-sections.txt b/docs/reference/gdk/gdk3-sections.txt
index 9d63807..cea9153 100644
--- a/docs/reference/gdk/gdk3-sections.txt
+++ b/docs/reference/gdk/gdk3-sections.txt
@@ -790,6 +790,8 @@ gdk_event_get_root_coords
 gdk_event_get_scroll_direction
 gdk_event_get_state
 gdk_event_get_time
+GdkEventSequence
+gdk_event_get_event_sequence
 gdk_event_request_motions
 gdk_events_get_angle
 gdk_events_get_center
diff --git a/gdk/gdk.symbols b/gdk/gdk.symbols
index 219153d..9552f3e 100644
--- a/gdk/gdk.symbols
+++ b/gdk/gdk.symbols
@@ -168,6 +168,7 @@ gdk_event_get_scroll_direction
 gdk_event_get_source_device
 gdk_event_get_state
 gdk_event_get_time
+gdk_event_get_event_sequence
 gdk_event_get_type
 gdk_event_handler_set
 gdk_event_mask_get_type
diff --git a/gdk/gdkevents.c b/gdk/gdkevents.c
index 6d24a8c..778ae3a 100644
--- a/gdk/gdkevents.c
+++ b/gdk/gdkevents.c
@@ -1685,6 +1685,27 @@ gdk_event_get_screen (const GdkEvent *event)
 }
 
 /**
+ * gdk_event_get_event_sequence:
+ * @event: a #GdkEvent
+ *
+ * If @event if of type %GDK_TOUCH_BEGIN, %GDK_TOUCH_UPDATE,
+ * %GDK_TOUCH_END or %GDK_TOUCH_CANCEL, returns the #GdkEventSequence
+ * to which the event belongs. Otherwise, return %NULL.
+ *
+ * Returns: the event sequence that the event belongs to
+ *
+ * Since: 3.4
+ */
+GdkEventSequence *
+gdk_event_get_event_sequence (const GdkEvent *event)
+{
+  if (!event)
+    return NULL;
+
+  return NULL;
+}
+
+/**
  * gdk_set_show_events:
  * @show_events:  %TRUE to output event debugging information.
  * 
diff --git a/gdk/gdkevents.h b/gdk/gdkevents.h
index 048537e..1fcbd56 100644
--- a/gdk/gdkevents.h
+++ b/gdk/gdkevents.h
@@ -143,6 +143,8 @@ typedef struct _GdkEventWindowState GdkEventWindowState;
 typedef struct _GdkEventSetting     GdkEventSetting;
 typedef struct _GdkEventGrabBroken  GdkEventGrabBroken;
 
+typedef struct _GdkEventSequence    GdkEventSequence;
+
 typedef union  _GdkEvent	    GdkEvent;
 
 /**
@@ -1155,6 +1157,8 @@ void       gdk_event_set_screen         (GdkEvent        *event,
                                          GdkScreen       *screen);
 GdkScreen *gdk_event_get_screen         (const GdkEvent  *event);
 
+GdkEventSequence *gdk_event_get_event_sequence (const GdkEvent *event);
+
 void	  gdk_set_show_events		(gboolean	 show_events);
 gboolean  gdk_get_show_events		(void);