]> Pileus Git - ~andy/gtk/blobdiff - gdk/gdkevents.c
Add gdk_screen_set_screen()/_get_screen() which (by evil hacks) work for
[~andy/gtk] / gdk / gdkevents.c
index 7823dbee350ffb1f4235c235863bbc01397e6546..ab93e69361817a62dfad212de8432b9afc55baf3 100644 (file)
 #include "gdkinternals.h"
 
 typedef struct _GdkIOClosure GdkIOClosure;
-typedef struct _GdkEventPrivate GdkEventPrivate;
-
-#define DOUBLE_CLICK_TIME      250
-#define TRIPLE_CLICK_TIME      500
-#define DOUBLE_CLICK_DIST      5
-#define TRIPLE_CLICK_DIST      5
-
-typedef enum
-{
-  /* Following flag is set for events on the event queue during
-   * translation and cleared afterwards.
-   */
-  GDK_EVENT_PENDING = 1 << 0
-} GdkEventFlags;
 
 struct _GdkIOClosure
 {
@@ -51,57 +37,34 @@ struct _GdkIOClosure
   gpointer data;
 };
 
-struct _GdkEventPrivate
-{
-  GdkEvent event;
-  guint    flags;
-};
-
-/* 
- * Private function declarations
- */
-
-GdkFilterReturn gdk_wm_protocols_filter (GdkXEvent *xev,
-                                        GdkEvent  *event,
-                                        gpointer   data);
-
 /* Private variable declarations
  */
 
-static guint32 button_click_time[2] = { 0, 0}; /* The last 2 button click times. Used
-                                               * to determine if the latest button click
-                                               * is part of a double or triple click.
-                                               */
-static GdkWindow *button_window[2] = { NULL, NULL}; /* The last 2 windows to receive button presses.
-                                                    *  Also used to determine if the latest button
-                                                    *  click is part of a double or triple click.
-                                            */
-static guint button_number[2] = { -1, -1 }; /* The last 2 buttons to be pressed.
-                                            */
-GdkEventFunc   gdk_event_func = NULL;    /* Callback for events */
-gpointer       gdk_event_data = NULL;
-GDestroyNotify gdk_event_notify = NULL;
-
-GPollFD event_poll_fd;
+GdkEventFunc   _gdk_event_func = NULL;    /* Callback for events */
+gpointer       _gdk_event_data = NULL;
+GDestroyNotify _gdk_event_notify = NULL;
+
+#define TRIPLE_CLICK_TIME(display) (2*display->double_click_time)
+#define DOUBLE_CLICK_DIST      5
+#define TRIPLE_CLICK_DIST      5
 
 /*********************************************
  * Functions for maintaining the event queue *
  *********************************************/
 
-/*************************************************************
- * gdk_event_queue_find_first:
- *     Find the first event on the queue that is not still
- *     being filled in.
- *   arguments:
- *     
- *   results:
- *     Pointer to the list node for that event, or NULL
- *************************************************************/
-
+/**
+ * _gdk_event_queue_find_first:
+ * @display: a #GdkDisplay
+ * 
+ * Find the first event on the queue that is not still
+ * being filled in.
+ * 
+ * Return value: Pointer to the list node for that event, or NULL.
+ **/
 GList*
-gdk_event_queue_find_first (void)
+_gdk_event_queue_find_first (GdkDisplay *display)
 {
-  GList *tmp_list = gdk_queued_events;
+  GList *tmp_list = display->queued_events;
 
   while (tmp_list)
     {
@@ -115,178 +78,226 @@ gdk_event_queue_find_first (void)
   return NULL;
 }
 
-/*************************************************************
- * gdk_event_queue_remove_link:
- *     Remove a specified list node from the event queue.
- *   arguments:
- *     node: Node to remove.
- *   results:
- *************************************************************/
+/**
+ * _gdk_event_queue_append:
+ * @display: a #GdkDisplay
+ * @event: Event to append.
+ * 
+ * Appends an event onto the tail of the event queue.
+ *
+ * Returns: the newly appended list node.
+ **/
+GList *
+_gdk_event_queue_append (GdkDisplay *display,
+                        GdkEvent   *event)
+{
+  display->queued_tail = g_list_append (display->queued_tail, event);
+  
+  if (!display->queued_events)
+    display->queued_events = display->queued_tail;
+  else
+    display->queued_tail = display->queued_tail->next;
 
+  return display->queued_tail;
+}
+
+/**
+ * _gdk_event_queue_remove_link:
+ * @display: a #GdkDisplay
+ * @node: node to remove
+ * 
+ * Removes a specified list node from the event queue.
+ **/
 void
-gdk_event_queue_remove_link (GList *node)
+_gdk_event_queue_remove_link (GdkDisplay *display,
+                             GList      *node)
 {
   if (node->prev)
     node->prev->next = node->next;
   else
-    gdk_queued_events = node->next;
+    display->queued_events = node->next;
   
   if (node->next)
     node->next->prev = node->prev;
   else
-    gdk_queued_tail = node->prev;
+    display->queued_tail = node->prev;
 }
 
-/*************************************************************
- * gdk_event_queue_append:
- *     Append an event onto the tail of the event queue.
- *   arguments:
- *     event: Event to append.
- *   results:
- *************************************************************/
-
-void
-gdk_event_queue_append (GdkEvent *event)
+/**
+ * _gdk_event_unqueue:
+ * @display: a #GdkDisplay
+ * 
+ * Removes and returns the first event from the event
+ * queue that is not still being filled in.
+ * 
+ * Return value: the event, or %NULL. Ownership is transferred
+ * to the caller.
+ **/
+GdkEvent*
+_gdk_event_unqueue (GdkDisplay *display)
 {
-  gdk_queued_tail = g_list_append (gdk_queued_tail, event);
-  
-  if (!gdk_queued_events)
-    gdk_queued_events = gdk_queued_tail;
-  else
-    gdk_queued_tail = gdk_queued_tail->next;
+  GdkEvent *event = NULL;
+  GList *tmp_list;
+
+  tmp_list = _gdk_event_queue_find_first (display);
+
+  if (tmp_list)
+    {
+      event = tmp_list->data;
+      _gdk_event_queue_remove_link (display, tmp_list);
+      g_list_free_1 (tmp_list);
+    }
+
+  return event;
 }
 
-/*************************************************************
+/**
  * gdk_event_handler_set:
- *     
- *   arguments:
- *     func: Callback function to be called for each event.
- *     data: Data supplied to the function
- *     notify: function called when function is no longer needed
+ * @func: the function to call to handle events from GDK.
+ * @data: user data to pass to the function. 
+ * @notify: the function to call when the handler function is removed, i.e. when
+ *          gdk_event_handler_set() is called with another event handler.
  * 
- *   results:
- *************************************************************/
-
+ * Sets the function to call to handle all events from GDK.
+ *
+ * Note that GTK+ uses this to install its own event handler, so it is
+ * usually not useful for GTK+ applications. (Although an application
+ * can call this function then call gtk_main_do_event() to pass
+ * events to GTK+.)
+ **/
 void 
 gdk_event_handler_set (GdkEventFunc   func,
                       gpointer       data,
                       GDestroyNotify notify)
 {
-  if (gdk_event_notify)
-    (*gdk_event_notify) (gdk_event_data);
+  if (_gdk_event_notify)
+    (*_gdk_event_notify) (_gdk_event_data);
 
-  gdk_event_func = func;
-  gdk_event_data = data;
-  gdk_event_notify = notify;
+  _gdk_event_func = func;
+  _gdk_event_data = data;
+  _gdk_event_notify = notify;
 }
 
-/*
- *--------------------------------------------------------------
- * gdk_event_get
- *
- *   Gets the next event.
- *
- * Arguments:
- *
- * Results:
- *   If an event is waiting that we care about, returns 
- *   a pointer to that event, to be freed with gdk_event_free.
- *   Otherwise, returns NULL.
- *
- * Side effects:
- *
- *--------------------------------------------------------------
- */
-
+/**
+ * gdk_event_get:
+ * 
+ * Checks all open displays for a #GdkEvent to process,to be processed
+ * on, fetching events from the windowing system if necessary.
+ * See gdk_display_get_event().
+ * 
+ * Return value: the next #GdkEvent to be processed, or %NULL if no events
+ * are pending. The returned #GdkEvent should be freed with gdk_event_free().
+ **/
 GdkEvent*
 gdk_event_get (void)
 {
-  gdk_events_queue ();
+  GSList *tmp_list;
 
-  return gdk_event_unqueue ();
+  for (tmp_list = _gdk_displays; tmp_list; tmp_list = tmp_list->next)
+    {
+      GdkEvent *event = gdk_display_get_event (tmp_list->data);
+      if (event)
+       return event;
+    }
+
+  return NULL;
 }
 
-/*
- *--------------------------------------------------------------
- * gdk_event_peek
- *
- *   Gets the next event.
- *
- * Arguments:
- *
- * Results:
- *   If an event is waiting that we care about, returns 
- *   a copy of that event, but does not remove it from
- *   the queue. The pointer is to be freed with gdk_event_free.
- *   Otherwise, returns NULL.
- *
- * Side effects:
+/**
+ * gdk_event_peek:
  *
- *--------------------------------------------------------------
- */
-
+ * If there is an event waiting in the event queue of some open
+ * display, returns a copy of it. See gdk_display_peek_event().
+ * 
+ * Return value: a copy of the first #GdkEvent on some event queue, or %NULL if no
+ * events are in any queues. The returned #GdkEvent should be freed with
+ * gdk_event_free().
+ **/
 GdkEvent*
 gdk_event_peek (void)
 {
-  GList *tmp_list;
+  GSList *tmp_list;
 
-  tmp_list = gdk_event_queue_find_first ();
-  
-  if (tmp_list)
-    return gdk_event_copy (tmp_list->data);
-  else
-    return NULL;
+  for (tmp_list = _gdk_displays; tmp_list; tmp_list = tmp_list->next)
+    {
+      GdkEvent *event = gdk_display_peek_event (tmp_list->data);
+      if (event)
+       return event;
+    }
+
+  return NULL;
 }
 
+/**
+ * gdk_event_put:
+ * @event: a #GdkEvent.
+ *
+ * Appends a copy of the given event onto the front of the event
+ * queue for event->any.window's display, or the default event
+ * queue if event->any.window is %NULL. See gdk_display_put_event().
+ **/
 void
 gdk_event_put (GdkEvent *event)
 {
-  GdkEvent *new_event;
+  GdkDisplay *display;
   
   g_return_if_fail (event != NULL);
-  
-  new_event = gdk_event_copy (event);
 
-  gdk_event_queue_append (new_event);
-}
+  if (event->any.window)
+    display = gdk_drawable_get_display (event->any.window);
+  else
+    {
+      GDK_NOTE (MULTIHEAD,
+               g_message ("Falling back to default display for gdk_event_put()"));
+      display = gdk_display_get_default ();
+    }
 
-/*
- *--------------------------------------------------------------
- * gdk_event_copy
- *
- *   Copy a event structure into new storage.
- *
- * Arguments:
- *   "event" is the event struct to copy.
- *
- * Results:
- *   A new event structure.  Free it with gdk_event_free.
- *
- * Side effects:
- *   The reference count of the window in the event is increased.
- *
- *--------------------------------------------------------------
- */
+  gdk_display_put_event (display, event);
+}
 
 static GMemChunk *event_chunk = NULL;
+static GHashTable *event_hash = NULL;
 
 GdkEvent*
-gdk_event_new (void)
+_gdk_event_new (void)
 {
   GdkEventPrivate *new_event;
   
   if (event_chunk == NULL)
-    event_chunk = g_mem_chunk_new ("events",
-                                  sizeof (GdkEventPrivate),
-                                  4096,
-                                  G_ALLOC_AND_FREE);
+    {
+      event_chunk = g_mem_chunk_new ("events",
+                                    sizeof (GdkEventPrivate),
+                                    4096,
+                                    G_ALLOC_AND_FREE);
+      event_hash = g_hash_table_new (g_direct_hash, NULL);
+    }
   
   new_event = g_chunk_new (GdkEventPrivate, event_chunk);
   new_event->flags = 0;
+  new_event->screen = NULL;
+
+  g_hash_table_insert (event_hash, new_event, GUINT_TO_POINTER (1));
   
   return (GdkEvent*) new_event;
 }
 
+static gboolean
+gdk_event_is_allocated (GdkEvent *event)
+{
+  if (event_hash)
+    return g_hash_table_lookup (event_hash, event) != NULL;
+}
+/**
+ * gdk_event_copy:
+ * @event: a #GdkEvent
+ * 
+ * Copies a #GdkEvent, copying or incrementing the reference count of the
+ * resources associated with it (e.g. #GdkWindow's and strings).
+ * 
+ * Return value: a copy of @event. The returned #GdkEvent should be freed with
+ * gdk_event_free().
+ **/
 GdkEvent*
 gdk_event_copy (GdkEvent *event)
 {
@@ -294,11 +305,11 @@ gdk_event_copy (GdkEvent *event)
   
   g_return_val_if_fail (event != NULL, NULL);
   
-  new_event = gdk_event_new ();
+  new_event = _gdk_event_new ();
   
   *new_event = *event;
   if (new_event->any.window)
-    gdk_window_ref (new_event->any.window);
+    g_object_ref (new_event->any.window);
   
   switch (event->any.type)
     {
@@ -310,7 +321,7 @@ gdk_event_copy (GdkEvent *event)
     case GDK_ENTER_NOTIFY:
     case GDK_LEAVE_NOTIFY:
       if (event->crossing.subwindow != NULL)
-       gdk_window_ref (event->crossing.subwindow);
+       g_object_ref (event->crossing.subwindow);
       break;
       
     case GDK_DRAG_ENTER:
@@ -319,7 +330,16 @@ gdk_event_copy (GdkEvent *event)
     case GDK_DRAG_STATUS:
     case GDK_DROP_START:
     case GDK_DROP_FINISHED:
-      gdk_drag_context_ref (event->dnd.context);
+      g_object_ref (event->dnd.context);
+      break;
+      
+    case GDK_EXPOSE:
+      if (event->expose.region)
+       new_event->expose.region = gdk_region_copy (event->expose.region);
+      break;
+      
+    case GDK_SETTING:
+      new_event->setting.name = g_strdup (new_event->setting.name);
       break;
       
     default:
@@ -329,24 +349,15 @@ gdk_event_copy (GdkEvent *event)
   return new_event;
 }
 
-/*
- *--------------------------------------------------------------
- * gdk_event_free
- *
- *   Free a event structure obtained from gdk_event_copy.  Do not use
- *   with other event structures.
- *
- * Arguments:
- *   "event" is the event struct to free.
- *
- * Results:
- *
- * Side effects:
- *   The reference count of the window in the event is decreased and
- *   might be freed, too.
- *
- *-------------------------------------------------------------- */
-
+/**
+ * gdk_event_free:
+ * @event:  a #GdkEvent.
+ * 
+ * Frees a #GdkEvent, freeing or decrementing any resources associated with it.
+ * Note that this function should only be called with events returned from
+ * functions such as gdk_event_peek(), gdk_event_get(),
+ * gdk_event_get_graphics_expose() and gdk_event_copy().
+ **/
 void
 gdk_event_free (GdkEvent *event)
 {
@@ -355,7 +366,7 @@ gdk_event_free (GdkEvent *event)
   g_assert (event_chunk != NULL); /* paranoid */
   
   if (event->any.window)
-    gdk_window_unref (event->any.window);
+    g_object_unref (event->any.window);
   
   switch (event->any.type)
     {
@@ -367,7 +378,7 @@ gdk_event_free (GdkEvent *event)
     case GDK_ENTER_NOTIFY:
     case GDK_LEAVE_NOTIFY:
       if (event->crossing.subwindow != NULL)
-       gdk_window_unref (event->crossing.subwindow);
+       g_object_unref (event->crossing.subwindow);
       break;
       
     case GDK_DRAG_ENTER:
@@ -376,7 +387,7 @@ gdk_event_free (GdkEvent *event)
     case GDK_DRAG_STATUS:
     case GDK_DROP_START:
     case GDK_DROP_FINISHED:
-      gdk_drag_context_unref (event->dnd.context);
+      g_object_unref (event->dnd.context);
       break;
 
     case GDK_BUTTON_PRESS:
@@ -384,31 +395,38 @@ gdk_event_free (GdkEvent *event)
       if (event->button.axes)
        g_free (event->button.axes);
       break;
-
+      
+    case GDK_EXPOSE:
+      if (event->expose.region)
+       gdk_region_destroy (event->expose.region);
+      break;
+      
     case GDK_MOTION_NOTIFY:
       if (event->motion.axes)
        g_free (event->motion.axes);
       break;
       
+    case GDK_SETTING:
+      g_free (event->setting.name);
+      break;
+      
     default:
       break;
     }
-  
+
+  g_hash_table_remove (event_chunk, event);
   g_mem_chunk_free (event_chunk, event);
 }
 
-/*
- *--------------------------------------------------------------
+/**
  * gdk_event_get_time:
- *    Get the timestamp from an event.
- *   arguments:
- *     event:
- *   results:
- *    The event's time stamp, if it has one, otherwise
- *    GDK_CURRENT_TIME.
- *--------------------------------------------------------------
- */
-
+ * @event: a #GdkEvent
+ * 
+ * Returns the time stamp from @event, if there is one; otherwise
+ * returns #GDK_CURRENT_TIME. If @event is %NULL, returns #GDK_CURRENT_TIME.
+ * 
+ * Return value: time stamp field from @event
+ **/
 guint32
 gdk_event_get_time (GdkEvent *event)
 {
@@ -457,6 +475,8 @@ gdk_event_get_time (GdkEvent *event)
       case GDK_EXPOSE:
       case GDK_MAP:
       case GDK_UNMAP:
+      case GDK_WINDOW_STATE:
+      case GDK_SETTING:
         /* return current time */
         break;
       }
@@ -471,7 +491,8 @@ gdk_event_get_time (GdkEvent *event)
  * 
  * If the event contains a "state" field, puts that field in @state. Otherwise
  * stores an empty state (0). Returns %TRUE if there was a state field
- * in the event.
+ * in the event. @event may be %NULL, in which case it's treated
+ * as if the event had no state field.
  * 
  * Return value: %TRUE if there was a state field in the event 
  **/
@@ -479,28 +500,35 @@ gboolean
 gdk_event_get_state (GdkEvent        *event,
                      GdkModifierType *state)
 {
+  g_return_val_if_fail (state != NULL, FALSE);
+  
   if (event)
     switch (event->type)
       {
       case GDK_MOTION_NOTIFY:
-       return event->motion.state;
+       *state = event->motion.state;
+        return TRUE;
       case GDK_BUTTON_PRESS:
       case GDK_2BUTTON_PRESS:
       case GDK_3BUTTON_PRESS:
       case GDK_BUTTON_RELEASE:
-        return event->button.state;
+        *state =  event->button.state;
+        return TRUE;
       case GDK_SCROLL:
-       return event->scroll.state;
+       *state =  event->scroll.state;
+        return TRUE;
       case GDK_KEY_PRESS:
       case GDK_KEY_RELEASE:
-       return event->key.state;
+       *state =  event->key.state;
+        return TRUE;
       case GDK_ENTER_NOTIFY:
       case GDK_LEAVE_NOTIFY:
-       return event->crossing.state;
+       *state =  event->crossing.state;
+        return TRUE;
       case GDK_PROPERTY_NOTIFY:
-       return event->property.state;
+       *state =  event->property.state;
+        return TRUE;
       case GDK_VISIBILITY_NOTIFY:
-        return event->visibility.state;
       case GDK_CLIENT_EVENT:
       case GDK_NO_EXPOSE:
       case GDK_CONFIGURE:
@@ -522,11 +550,133 @@ gdk_event_get_state (GdkEvent        *event,
       case GDK_EXPOSE:
       case GDK_MAP:
       case GDK_UNMAP:
+      case GDK_WINDOW_STATE:
+      case GDK_SETTING:
         /* no state field */
         break;
       }
 
-  return 0;
+  *state = 0;
+  return FALSE;
+}
+
+/**
+ * gdk_event_get_coords:
+ * @event: a #GdkEvent
+ * @x_win: location to put event window x coordinate
+ * @y_win: location to put event window y coordinate
+ * 
+ * Extract the event window relative x/y coordinates from an event.
+ * 
+ * Return value: %TRUE if the event delivered event window coordinates
+ **/
+gboolean
+gdk_event_get_coords (GdkEvent *event,
+                     gdouble  *x_win,
+                     gdouble  *y_win)
+{
+  gdouble x = 0, y = 0;
+  gboolean fetched = TRUE;
+  
+  g_return_val_if_fail (event != NULL, FALSE);
+
+  switch (event->type)
+    {
+    case GDK_CONFIGURE:
+      x = event->configure.x;
+      y = event->configure.y;
+      break;
+    case GDK_ENTER_NOTIFY:
+    case GDK_LEAVE_NOTIFY:
+      x = event->crossing.x;
+      y = event->crossing.y;
+      break;
+    case GDK_SCROLL:
+      x = event->scroll.x;
+      y = event->scroll.y;
+      break;
+    case GDK_BUTTON_PRESS:
+    case GDK_2BUTTON_PRESS:
+    case GDK_3BUTTON_PRESS:
+    case GDK_BUTTON_RELEASE:
+      x = event->button.x;
+      y = event->button.y;
+      break;
+    case GDK_MOTION_NOTIFY:
+      x = event->motion.x;
+      y = event->motion.y;
+      break;
+    default:
+      fetched = FALSE;
+      break;
+    }
+
+  if (x_win)
+    *x_win = x;
+  if (y_win)
+    *y_win = y;
+
+  return fetched;
+}
+
+/**
+ * gdk_event_get_root_coords:
+ * @event: a #GdkEvent
+ * @x_root: location to put root window x coordinate
+ * @y_root: location to put root window y coordinate
+ * 
+ * Extract the root window relative x/y coordinates from an event.
+ * 
+ * Return value: %TRUE if the event delivered root window coordinates
+ **/
+gboolean
+gdk_event_get_root_coords (GdkEvent *event,
+                          gdouble  *x_root,
+                          gdouble  *y_root)
+{
+  gdouble x = 0, y = 0;
+  gboolean fetched = TRUE;
+  
+  g_return_val_if_fail (event != NULL, FALSE);
+
+  switch (event->type)
+    {
+    case GDK_MOTION_NOTIFY:
+      x = event->motion.x_root;
+      y = event->motion.y_root;
+      break;
+    case GDK_BUTTON_PRESS:
+    case GDK_2BUTTON_PRESS:
+    case GDK_3BUTTON_PRESS:
+    case GDK_BUTTON_RELEASE:
+      x = event->button.x_root;
+      y = event->button.y_root;
+      break;
+    case GDK_ENTER_NOTIFY:
+    case GDK_LEAVE_NOTIFY:
+      x = event->crossing.x_root;
+      y = event->crossing.y_root;
+      break;
+    case GDK_DRAG_ENTER:
+    case GDK_DRAG_LEAVE:
+    case GDK_DRAG_MOTION:
+    case GDK_DRAG_STATUS:
+    case GDK_DROP_START:
+    case GDK_DROP_FINISHED:
+      x = event->dnd.x_root;
+      y = event->dnd.y_root;
+      break;
+    default:
+      fetched = FALSE;
+      break;
+    }
+
+  if (x_root)
+    *x_root = x;
+  if (y_root)
+    *y_root = y;
+
+  return fetched;
 }
 
 /**
@@ -603,39 +753,88 @@ gdk_event_get_axis (GdkEvent   *event,
   return gdk_device_get_axis (device, axes, axis_use, value);
 }
 
-/*
- *--------------------------------------------------------------
- * gdk_set_show_events
- *
- *   Turns on/off the showing of events.
- *
- * Arguments:
- *   "show_events" is a boolean describing whether or
- *   not to show the events gdk receives.
- *
- * Results:
- *
- * Side effects:
- *   When "show_events" is TRUE, calls to "gdk_event_get"
- *   will output debugging informatin regarding the event
- *   received to stdout.
- *
- *--------------------------------------------------------------
- */
+/**
+ * gdk_event_set_screen:
+ * @event: a #GdkEvent
+ * @screen: a #GdkScreen
+ * 
+ * Sets the screen for @event to @screen. The event must
+ * have been allocated by GTK+, for instance, by
+ * gdk_event_copy().
+ **/
+void
+gdk_event_set_screen (GdkEvent  *event,
+                     GdkScreen *screen)
+{
+  GdkEventPrivate *private;
+  
+  g_return_if_fail (gdk_event_is_allocated (event));
+
+  private = (GdkEventPrivate *)event;
+  
+  private->screen = screen;
+}
+
+/**
+ * gdk_event_get_screen:
+ * @event: a #GdkEvent
+ * 
+ * Returns the screen for the event. The screen is
+ * typically the screen for event->any.window, but
+ * for events such as mouse events, it is the screen
+ * where the the pointer was when the event occurs -
+ * that is, the screen which has the root window 
+ * to which event->motion.x_root and
+ * event->motion.y_root are relative.
+ * 
+ * Return value: the screen for the event
+ **/
+GdkScreen *
+gdk_event_get_screen (GdkEvent *event)
+{
+  if (gdk_event_is_allocated (event))
+    {
+      GdkEventPrivate *private = (GdkEventPrivate *)event;
+
+      if (private->screen)
+       return private->screen;
+    }
+
+  if (event->any.window)
+    return gdk_drawable_get_screen (event->any.window);
 
+  return NULL;
+}
+
+/**
+ * gdk_set_show_events:
+ * @show_events:  %TRUE to output event debugging information.
+ * 
+ * Sets whether a trace of received events is output.
+ * Note that GTK+ must be compiled with debugging (that is,
+ * configured using the <option>--enable-debug</option> option)
+ * to use this option.
+ **/
 void
 gdk_set_show_events (gboolean show_events)
 {
   if (show_events)
-    gdk_debug_flags |= GDK_DEBUG_EVENTS;
+    _gdk_debug_flags |= GDK_DEBUG_EVENTS;
   else
-    gdk_debug_flags &= ~GDK_DEBUG_EVENTS;
+    _gdk_debug_flags &= ~GDK_DEBUG_EVENTS;
 }
 
+/**
+ * gdk_get_show_events:
+ * 
+ * Gets whether event debugging output is enabled.
+ * 
+ * Return value: %TRUE if event debugging output is enabled.
+ **/
 gboolean
 gdk_get_show_events (void)
 {
-  return (gdk_debug_flags & GDK_DEBUG_EVENTS) != 0;
+  return (_gdk_debug_flags & GDK_DEBUG_EVENTS) != 0;
 }
 
 static void
@@ -724,27 +923,10 @@ gdk_input_remove (gint tag)
   g_source_remove (tag);
 }
 
-GdkEvent*
-gdk_event_unqueue (void)
-{
-  GdkEvent *event = NULL;
-  GList *tmp_list;
-
-  tmp_list = gdk_event_queue_find_first ();
-
-  if (tmp_list)
-    {
-      event = tmp_list->data;
-      gdk_event_queue_remove_link (tmp_list);
-      g_list_free_1 (tmp_list);
-    }
-
-  return event;
-}
-
-void
-gdk_synthesize_click (GdkEvent *event,
-                     gint      nclicks)
+static void
+gdk_synthesize_click (GdkDisplay *display,
+                     GdkEvent   *event,
+                     gint        nclicks)
 {
   GdkEvent temp_event;
   
@@ -753,45 +935,157 @@ gdk_synthesize_click (GdkEvent *event,
   temp_event = *event;
   temp_event.type = (nclicks == 2) ? GDK_2BUTTON_PRESS : GDK_3BUTTON_PRESS;
   
-  gdk_event_put (&temp_event);
+  gdk_display_put_event (display, &temp_event);
 }
 
 void
-gdk_event_button_generate (GdkEvent *event)
+_gdk_event_button_generate (GdkDisplay *display,
+                           GdkEvent   *event)
 {
-  if ((event->button.time < (button_click_time[1] + TRIPLE_CLICK_TIME)) &&
-      (event->button.window == button_window[1]) &&
-      (event->button.button == button_number[1]))
+  if ((event->button.time < (display->button_click_time[1] + TRIPLE_CLICK_TIME (display))) &&
+      (event->button.window == display->button_window[1]) &&
+      (event->button.button == display->button_number[1]))
     {
-      gdk_synthesize_click (event, 3);
+      gdk_synthesize_click (display, event, 3);
       
-      button_click_time[1] = 0;
-      button_click_time[0] = 0;
-      button_window[1] = NULL;
-      button_window[0] = 0;
-      button_number[1] = -1;
-      button_number[0] = -1;
+      display->button_click_time[1] = 0;
+      display->button_click_time[0] = 0;
+      display->button_window[1] = NULL;
+      display->button_window[0] = 0;
+      display->button_number[1] = -1;
+      display->button_number[0] = -1;
     }
-  else if ((event->button.time < (button_click_time[0] + DOUBLE_CLICK_TIME)) &&
-          (event->button.window == button_window[0]) &&
-          (event->button.button == button_number[0]))
+  else if ((event->button.time < (display->button_click_time[0] + display->double_click_time)) &&
+          (event->button.window == display->button_window[0]) &&
+          (event->button.button == display->button_number[0]))
     {
-      gdk_synthesize_click (event, 2);
+      gdk_synthesize_click (display, event, 2);
       
-      button_click_time[1] = button_click_time[0];
-      button_click_time[0] = event->button.time;
-      button_window[1] = button_window[0];
-      button_window[0] = event->button.window;
-      button_number[1] = button_number[0];
-      button_number[0] = event->button.button;
+      display->button_click_time[1] = display->button_click_time[0];
+      display->button_click_time[0] = event->button.time;
+      display->button_window[1] = display->button_window[0];
+      display->button_window[0] = event->button.window;
+      display->button_number[1] = display->button_number[0];
+      display->button_number[0] = event->button.button;
     }
   else
     {
-      button_click_time[1] = 0;
-      button_click_time[0] = event->button.time;
-      button_window[1] = NULL;
-      button_window[0] = event->button.window;
-      button_number[1] = -1;
-      button_number[0] = event->button.button;
+      display->button_click_time[1] = 0;
+      display->button_click_time[0] = event->button.time;
+      display->button_window[1] = NULL;
+      display->button_window[0] = event->button.window;
+      display->button_number[1] = -1;
+      display->button_number[0] = event->button.button;
+    }
+}
+
+void
+gdk_synthesize_window_state (GdkWindow     *window,
+                             GdkWindowState unset_flags,
+                             GdkWindowState set_flags)
+{
+  GdkEvent temp_event;
+  GdkWindowState old;
+  
+  g_return_if_fail (window != NULL);
+  
+  temp_event.window_state.window = window;
+  temp_event.window_state.type = GDK_WINDOW_STATE;
+  temp_event.window_state.send_event = FALSE;
+  
+  old = ((GdkWindowObject*) temp_event.window_state.window)->state;
+  
+  temp_event.window_state.changed_mask = (unset_flags | set_flags) ^ old;
+  temp_event.window_state.new_window_state = old;
+  temp_event.window_state.new_window_state |= set_flags;
+  temp_event.window_state.new_window_state &= ~unset_flags;
+
+  if (temp_event.window_state.new_window_state == old)
+    return; /* No actual work to do, nothing changed. */
+
+  /* Actually update the field in GdkWindow, this is sort of an odd
+   * place to do it, but seems like the safest since it ensures we expose no
+   * inconsistent state to the user.
+   */
+  
+  ((GdkWindowObject*) window)->state = temp_event.window_state.new_window_state;
+
+  /* We only really send the event to toplevels, since
+   * all the window states don't apply to non-toplevels.
+   * Non-toplevels do use the GDK_WINDOW_STATE_WITHDRAWN flag
+   * internally so we needed to update window->state.
+   */
+  switch (((GdkWindowObject*) window)->window_type)
+    {
+    case GDK_WINDOW_TOPLEVEL:
+    case GDK_WINDOW_DIALOG:
+    case GDK_WINDOW_TEMP: /* ? */
+      gdk_display_put_event (gdk_drawable_get_display (window), &temp_event);
+      break;
+      
+    case GDK_WINDOW_FOREIGN:
+    case GDK_WINDOW_ROOT:
+    case GDK_WINDOW_CHILD:
+      break;
     }
 }
+
+/**
+ * gdk_display_set_double_click_time:
+ * @display: a #GdkDisplay
+ * @msec: double click time in milliseconds (thousandths of a second) 
+ * 
+ * Sets the double click time (two clicks within this time interval
+ * count as a double click and result in a #GDK_2BUTTON_PRESS event).
+ * Applications should NOT set this, it is a global user-configured setting.
+ **/
+void
+gdk_display_set_double_click_time (GdkDisplay *display,
+                                  guint       msec)
+{
+  display->double_click_time = msec;
+}
+
+/**
+ * gdk_set_double_click_time:
+ * @msec: double click time in milliseconds (thousandths of a second)
+ *
+ * Set the double click time for the default display. See
+ * gdk_display_set_double_click_time(). Applications should NOT
+ * set this, it is a global user-configured setting.
+ **/
+void
+gdk_set_double_click_time (guint msec)
+{
+  gdk_display_set_double_click_time (gdk_display_get_default (), msec);
+}
+
+GType
+gdk_event_get_type (void)
+{
+  static GType our_type = 0;
+  
+  if (our_type == 0)
+    our_type = g_boxed_type_register_static ("GdkEvent",
+                                            (GBoxedCopyFunc)gdk_event_copy,
+                                            (GBoxedFreeFunc)gdk_event_free);
+  return our_type;
+}
+
+/**
+ * gdk_setting_get:
+ * @name: the name of the setting.
+ * @value: location to store the value of the setting.
+ *
+ * Obtains a desktop-wide setting, such as the double-click time,
+ * for the default screen. See gdk_screen_get_setting().
+ *
+ * Returns : %TRUE if the setting existed and a value was stored
+ *   in @value, %FALSE otherwise.
+ **/
+gboolean
+gdk_setting_get (const gchar *name,
+                GValue      *value)
+{
+  return gdk_screen_get_setting (gdk_screen_get_default (), name, value);
+}