1 /* GDK - The GIMP Drawing Kit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
21 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
22 * file for a list of people on the GTK+ Team. See the ChangeLog
23 * files for a list of changes. These files are distributed with
24 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
28 #include <string.h> /* For memset() */
31 #include "gdkinternals.h"
34 typedef struct _GdkIOClosure GdkIOClosure;
38 GdkInputFunction function;
39 GdkInputCondition condition;
40 GDestroyNotify notify;
44 /* Private variable declarations
47 GdkEventFunc _gdk_event_func = NULL; /* Callback for events */
48 gpointer _gdk_event_data = NULL;
49 GDestroyNotify _gdk_event_notify = NULL;
51 /*********************************************
52 * Functions for maintaining the event queue *
53 *********************************************/
56 * _gdk_event_queue_find_first:
57 * @display: a #GdkDisplay
59 * Find the first event on the queue that is not still
62 * Return value: Pointer to the list node for that event, or NULL.
65 _gdk_event_queue_find_first (GdkDisplay *display)
67 GList *tmp_list = display->queued_events;
71 GdkEventPrivate *event = tmp_list->data;
72 if (!(event->flags & GDK_EVENT_PENDING))
75 tmp_list = g_list_next (tmp_list);
82 * _gdk_event_queue_prepend:
83 * @display: a #GdkDisplay
84 * @event: Event to prepend.
86 * Prepends an event before the head of the event queue.
88 * Returns: the newly prepended list node.
91 _gdk_event_queue_prepend (GdkDisplay *display,
94 display->queued_events = g_list_prepend (display->queued_events, event);
95 if (!display->queued_tail)
96 display->queued_tail = display->queued_events;
97 return display->queued_events;
101 * _gdk_event_queue_append:
102 * @display: a #GdkDisplay
103 * @event: Event to append.
105 * Appends an event onto the tail of the event queue.
107 * Returns: the newly appended list node.
110 _gdk_event_queue_append (GdkDisplay *display,
113 display->queued_tail = g_list_append (display->queued_tail, event);
115 if (!display->queued_events)
116 display->queued_events = display->queued_tail;
118 display->queued_tail = display->queued_tail->next;
120 return display->queued_tail;
124 * _gdk_event_queue_remove_link:
125 * @display: a #GdkDisplay
126 * @node: node to remove
128 * Removes a specified list node from the event queue.
131 _gdk_event_queue_remove_link (GdkDisplay *display,
135 node->prev->next = node->next;
137 display->queued_events = node->next;
140 node->next->prev = node->prev;
142 display->queued_tail = node->prev;
146 * _gdk_event_unqueue:
147 * @display: a #GdkDisplay
149 * Removes and returns the first event from the event
150 * queue that is not still being filled in.
152 * Return value: the event, or %NULL. Ownership is transferred
156 _gdk_event_unqueue (GdkDisplay *display)
158 GdkEvent *event = NULL;
161 tmp_list = _gdk_event_queue_find_first (display);
165 event = tmp_list->data;
166 _gdk_event_queue_remove_link (display, tmp_list);
167 g_list_free_1 (tmp_list);
174 * gdk_event_handler_set:
175 * @func: the function to call to handle events from GDK.
176 * @data: user data to pass to the function.
177 * @notify: the function to call when the handler function is removed, i.e. when
178 * gdk_event_handler_set() is called with another event handler.
180 * Sets the function to call to handle all events from GDK.
182 * Note that GTK+ uses this to install its own event handler, so it is
183 * usually not useful for GTK+ applications. (Although an application
184 * can call this function then call gtk_main_do_event() to pass
188 gdk_event_handler_set (GdkEventFunc func,
190 GDestroyNotify notify)
192 if (_gdk_event_notify)
193 (*_gdk_event_notify) (_gdk_event_data);
195 _gdk_event_func = func;
196 _gdk_event_data = data;
197 _gdk_event_notify = notify;
203 * Checks all open displays for a #GdkEvent to process,to be processed
204 * on, fetching events from the windowing system if necessary.
205 * See gdk_display_get_event().
207 * Return value: the next #GdkEvent to be processed, or %NULL if no events
208 * are pending. The returned #GdkEvent should be freed with gdk_event_free().
215 for (tmp_list = _gdk_displays; tmp_list; tmp_list = tmp_list->next)
217 GdkEvent *event = gdk_display_get_event (tmp_list->data);
228 * If there is an event waiting in the event queue of some open
229 * display, returns a copy of it. See gdk_display_peek_event().
231 * Return value: a copy of the first #GdkEvent on some event queue, or %NULL if no
232 * events are in any queues. The returned #GdkEvent should be freed with
236 gdk_event_peek (void)
240 for (tmp_list = _gdk_displays; tmp_list; tmp_list = tmp_list->next)
242 GdkEvent *event = gdk_display_peek_event (tmp_list->data);
252 * @event: a #GdkEvent.
254 * Appends a copy of the given event onto the front of the event
255 * queue for event->any.window's display, or the default event
256 * queue if event->any.window is %NULL. See gdk_display_put_event().
259 gdk_event_put (const GdkEvent *event)
263 g_return_if_fail (event != NULL);
265 if (event->any.window)
266 display = gdk_drawable_get_display (event->any.window);
270 g_message ("Falling back to default display for gdk_event_put()"));
271 display = gdk_display_get_default ();
274 gdk_display_put_event (display, event);
277 static GHashTable *event_hash = NULL;
281 * @type: a #GdkEventType
283 * Creates a new event of the given type. All fields are set to 0.
285 * Return value: a newly-allocated #GdkEvent. The returned #GdkEvent
286 * should be freed with gdk_event_free().
291 gdk_event_new (GdkEventType type)
293 GdkEventPrivate *new_private;
297 event_hash = g_hash_table_new (g_direct_hash, NULL);
299 new_private = g_slice_new0 (GdkEventPrivate);
301 new_private->flags = 0;
302 new_private->screen = NULL;
304 g_hash_table_insert (event_hash, new_private, GUINT_TO_POINTER (1));
306 new_event = (GdkEvent *) new_private;
308 new_event->any.type = type;
311 * Bytewise 0 initialization is reasonable for most of the
312 * current event types. Explicitely initialize double fields
313 * since I trust bytewise 0 == 0. less than for integers
318 case GDK_MOTION_NOTIFY:
319 new_event->motion.x = 0.;
320 new_event->motion.y = 0.;
321 new_event->motion.x_root = 0.;
322 new_event->motion.y_root = 0.;
324 case GDK_BUTTON_PRESS:
325 case GDK_2BUTTON_PRESS:
326 case GDK_3BUTTON_PRESS:
327 case GDK_BUTTON_RELEASE:
328 new_event->button.x = 0.;
329 new_event->button.y = 0.;
330 new_event->button.x_root = 0.;
331 new_event->button.y_root = 0.;
334 new_event->scroll.x = 0.;
335 new_event->scroll.y = 0.;
336 new_event->scroll.x_root = 0.;
337 new_event->scroll.y_root = 0.;
339 case GDK_ENTER_NOTIFY:
340 case GDK_LEAVE_NOTIFY:
341 new_event->crossing.x = 0.;
342 new_event->crossing.y = 0.;
343 new_event->crossing.x_root = 0.;
344 new_event->crossing.y_root = 0.;
354 gdk_event_is_allocated (const GdkEvent *event)
357 return g_hash_table_lookup (event_hash, event) != NULL;
364 * @event: a #GdkEvent
366 * Copies a #GdkEvent, copying or incrementing the reference count of the
367 * resources associated with it (e.g. #GdkWindow's and strings).
369 * Return value: a copy of @event. The returned #GdkEvent should be freed with
373 gdk_event_copy (const GdkEvent *event)
375 GdkEventPrivate *new_private;
378 g_return_val_if_fail (event != NULL, NULL);
380 new_event = gdk_event_new (GDK_NOTHING);
381 new_private = (GdkEventPrivate *)new_event;
384 if (new_event->any.window)
385 g_object_ref (new_event->any.window);
387 if (gdk_event_is_allocated (event))
389 GdkEventPrivate *private = (GdkEventPrivate *)event;
391 new_private->screen = private->screen;
394 switch (event->any.type)
397 case GDK_KEY_RELEASE:
398 new_event->key.string = g_strdup (event->key.string);
401 case GDK_ENTER_NOTIFY:
402 case GDK_LEAVE_NOTIFY:
403 if (event->crossing.subwindow != NULL)
404 g_object_ref (event->crossing.subwindow);
409 case GDK_DRAG_MOTION:
410 case GDK_DRAG_STATUS:
412 case GDK_DROP_FINISHED:
413 g_object_ref (event->dnd.context);
417 if (event->expose.region)
418 new_event->expose.region = gdk_region_copy (event->expose.region);
422 new_event->setting.name = g_strdup (new_event->setting.name);
425 case GDK_BUTTON_PRESS:
426 case GDK_BUTTON_RELEASE:
427 if (event->button.axes)
428 new_event->button.axes = g_memdup (event->button.axes,
429 sizeof (gdouble) * event->button.device->num_axes);
432 case GDK_MOTION_NOTIFY:
433 if (event->motion.axes)
434 new_event->motion.axes = g_memdup (event->motion.axes,
435 sizeof (gdouble) * event->motion.device->num_axes);
443 if (gdk_event_is_allocated (event))
444 _gdk_windowing_event_data_copy (event, new_event);
451 * @event: a #GdkEvent.
453 * Frees a #GdkEvent, freeing or decrementing any resources associated with it.
454 * Note that this function should only be called with events returned from
455 * functions such as gdk_event_peek(), gdk_event_get(),
456 * gdk_event_get_graphics_expose() and gdk_event_copy().
459 gdk_event_free (GdkEvent *event)
461 g_return_if_fail (event != NULL);
463 if (event->any.window)
464 g_object_unref (event->any.window);
466 switch (event->any.type)
469 case GDK_KEY_RELEASE:
470 g_free (event->key.string);
473 case GDK_ENTER_NOTIFY:
474 case GDK_LEAVE_NOTIFY:
475 if (event->crossing.subwindow != NULL)
476 g_object_unref (event->crossing.subwindow);
481 case GDK_DRAG_MOTION:
482 case GDK_DRAG_STATUS:
484 case GDK_DROP_FINISHED:
485 g_object_unref (event->dnd.context);
488 case GDK_BUTTON_PRESS:
489 case GDK_BUTTON_RELEASE:
490 g_free (event->button.axes);
494 if (event->expose.region)
495 gdk_region_destroy (event->expose.region);
498 case GDK_MOTION_NOTIFY:
499 g_free (event->motion.axes);
503 g_free (event->setting.name);
510 _gdk_windowing_event_data_free (event);
512 g_hash_table_remove (event_hash, event);
513 g_slice_free (GdkEventPrivate, (GdkEventPrivate*) event);
517 * gdk_event_get_time:
518 * @event: a #GdkEvent
520 * Returns the time stamp from @event, if there is one; otherwise
521 * returns #GDK_CURRENT_TIME. If @event is %NULL, returns #GDK_CURRENT_TIME.
523 * Return value: time stamp field from @event
526 gdk_event_get_time (const GdkEvent *event)
531 case GDK_MOTION_NOTIFY:
532 return event->motion.time;
533 case GDK_BUTTON_PRESS:
534 case GDK_2BUTTON_PRESS:
535 case GDK_3BUTTON_PRESS:
536 case GDK_BUTTON_RELEASE:
537 return event->button.time;
539 return event->scroll.time;
541 case GDK_KEY_RELEASE:
542 return event->key.time;
543 case GDK_ENTER_NOTIFY:
544 case GDK_LEAVE_NOTIFY:
545 return event->crossing.time;
546 case GDK_PROPERTY_NOTIFY:
547 return event->property.time;
548 case GDK_SELECTION_CLEAR:
549 case GDK_SELECTION_REQUEST:
550 case GDK_SELECTION_NOTIFY:
551 return event->selection.time;
552 case GDK_PROXIMITY_IN:
553 case GDK_PROXIMITY_OUT:
554 return event->proximity.time;
557 case GDK_DRAG_MOTION:
558 case GDK_DRAG_STATUS:
560 case GDK_DROP_FINISHED:
561 return event->dnd.time;
562 case GDK_CLIENT_EVENT:
563 case GDK_VISIBILITY_NOTIFY:
566 case GDK_FOCUS_CHANGE:
574 case GDK_WINDOW_STATE:
576 case GDK_OWNER_CHANGE:
577 case GDK_GRAB_BROKEN:
578 /* return current time */
582 return GDK_CURRENT_TIME;
586 * gdk_event_get_state:
587 * @event: a #GdkEvent or NULL
588 * @state: return location for state
590 * If the event contains a "state" field, puts that field in @state. Otherwise
591 * stores an empty state (0). Returns %TRUE if there was a state field
592 * in the event. @event may be %NULL, in which case it's treated
593 * as if the event had no state field.
595 * Return value: %TRUE if there was a state field in the event
598 gdk_event_get_state (const GdkEvent *event,
599 GdkModifierType *state)
601 g_return_val_if_fail (state != NULL, FALSE);
606 case GDK_MOTION_NOTIFY:
607 *state = event->motion.state;
609 case GDK_BUTTON_PRESS:
610 case GDK_2BUTTON_PRESS:
611 case GDK_3BUTTON_PRESS:
612 case GDK_BUTTON_RELEASE:
613 *state = event->button.state;
616 *state = event->scroll.state;
619 case GDK_KEY_RELEASE:
620 *state = event->key.state;
622 case GDK_ENTER_NOTIFY:
623 case GDK_LEAVE_NOTIFY:
624 *state = event->crossing.state;
626 case GDK_PROPERTY_NOTIFY:
627 *state = event->property.state;
629 case GDK_VISIBILITY_NOTIFY:
630 case GDK_CLIENT_EVENT:
633 case GDK_FOCUS_CHANGE:
634 case GDK_SELECTION_CLEAR:
635 case GDK_SELECTION_REQUEST:
636 case GDK_SELECTION_NOTIFY:
637 case GDK_PROXIMITY_IN:
638 case GDK_PROXIMITY_OUT:
642 case GDK_DRAG_MOTION:
643 case GDK_DRAG_STATUS:
645 case GDK_DROP_FINISHED:
652 case GDK_WINDOW_STATE:
654 case GDK_OWNER_CHANGE:
655 case GDK_GRAB_BROKEN:
665 * gdk_event_get_coords:
666 * @event: a #GdkEvent
667 * @x_win: location to put event window x coordinate
668 * @y_win: location to put event window y coordinate
670 * Extract the event window relative x/y coordinates from an event.
672 * Return value: %TRUE if the event delivered event window coordinates
675 gdk_event_get_coords (const GdkEvent *event,
679 gdouble x = 0, y = 0;
680 gboolean fetched = TRUE;
682 g_return_val_if_fail (event != NULL, FALSE);
687 x = event->configure.x;
688 y = event->configure.y;
690 case GDK_ENTER_NOTIFY:
691 case GDK_LEAVE_NOTIFY:
692 x = event->crossing.x;
693 y = event->crossing.y;
699 case GDK_BUTTON_PRESS:
700 case GDK_2BUTTON_PRESS:
701 case GDK_3BUTTON_PRESS:
702 case GDK_BUTTON_RELEASE:
706 case GDK_MOTION_NOTIFY:
724 * gdk_event_get_root_coords:
725 * @event: a #GdkEvent
726 * @x_root: location to put root window x coordinate
727 * @y_root: location to put root window y coordinate
729 * Extract the root window relative x/y coordinates from an event.
731 * Return value: %TRUE if the event delivered root window coordinates
734 gdk_event_get_root_coords (const GdkEvent *event,
738 gdouble x = 0, y = 0;
739 gboolean fetched = TRUE;
741 g_return_val_if_fail (event != NULL, FALSE);
745 case GDK_MOTION_NOTIFY:
746 x = event->motion.x_root;
747 y = event->motion.y_root;
750 x = event->scroll.x_root;
751 y = event->scroll.y_root;
753 case GDK_BUTTON_PRESS:
754 case GDK_2BUTTON_PRESS:
755 case GDK_3BUTTON_PRESS:
756 case GDK_BUTTON_RELEASE:
757 x = event->button.x_root;
758 y = event->button.y_root;
760 case GDK_ENTER_NOTIFY:
761 case GDK_LEAVE_NOTIFY:
762 x = event->crossing.x_root;
763 y = event->crossing.y_root;
767 case GDK_DRAG_MOTION:
768 case GDK_DRAG_STATUS:
770 case GDK_DROP_FINISHED:
771 x = event->dnd.x_root;
772 y = event->dnd.y_root;
788 * gdk_event_get_axis:
789 * @event: a #GdkEvent
790 * @axis_use: the axis use to look for
791 * @value: location to store the value found
793 * Extract the axis value for a particular axis use from
794 * an event structure.
796 * Return value: %TRUE if the specified axis was found, otherwise %FALSE
799 gdk_event_get_axis (const GdkEvent *event,
806 g_return_val_if_fail (event != NULL, FALSE);
808 if (axis_use == GDK_AXIS_X || axis_use == GDK_AXIS_Y)
814 case GDK_MOTION_NOTIFY:
822 case GDK_BUTTON_PRESS:
823 case GDK_BUTTON_RELEASE:
827 case GDK_ENTER_NOTIFY:
828 case GDK_LEAVE_NOTIFY:
829 x = event->crossing.x;
830 y = event->crossing.y;
837 if (axis_use == GDK_AXIS_X && value)
839 if (axis_use == GDK_AXIS_Y && value)
844 else if (event->type == GDK_BUTTON_PRESS ||
845 event->type == GDK_BUTTON_RELEASE)
847 device = event->button.device;
848 axes = event->button.axes;
850 else if (event->type == GDK_MOTION_NOTIFY)
852 device = event->motion.device;
853 axes = event->motion.axes;
858 return gdk_device_get_axis (device, axes, axis_use, value);
862 * gdk_event_request_motions:
863 * @event: a valid #GdkEvent
865 * Request more motion notifies if @event is a motion notify hint event.
866 * This function should be used instead of gdk_window_get_pointer() to
867 * request further motion notifies, because it also works for extension
868 * events where motion notifies are provided for devices other than the
869 * core pointer. Coordinate extraction, processing and requesting more
870 * motion events from a %GDK_MOTION_NOTIFY event usually works like this:
874 * /* motion_event handler */
875 * x = motion_event->x;
876 * y = motion_event->y;
877 * /* handle (x,y) motion */
878 * gdk_event_request_motions (motion_event); /* handles is_hint events */
885 gdk_event_request_motions (const GdkEventMotion *event)
887 g_return_if_fail (event != NULL);
888 if (event->type == GDK_MOTION_NOTIFY && event->is_hint)
889 gdk_device_get_state (event->device, event->window, NULL, NULL);
893 * gdk_event_set_screen:
894 * @event: a #GdkEvent
895 * @screen: a #GdkScreen
897 * Sets the screen for @event to @screen. The event must
898 * have been allocated by GTK+, for instance, by
904 gdk_event_set_screen (GdkEvent *event,
907 GdkEventPrivate *private;
909 g_return_if_fail (gdk_event_is_allocated (event));
911 private = (GdkEventPrivate *)event;
913 private->screen = screen;
917 * gdk_event_get_screen:
918 * @event: a #GdkEvent
920 * Returns the screen for the event. The screen is
921 * typically the screen for <literal>event->any.window</literal>, but
922 * for events such as mouse events, it is the screen
923 * where the pointer was when the event occurs -
924 * that is, the screen which has the root window
925 * to which <literal>event->motion.x_root</literal> and
926 * <literal>event->motion.y_root</literal> are relative.
928 * Return value: the screen for the event
933 gdk_event_get_screen (const GdkEvent *event)
935 if (gdk_event_is_allocated (event))
937 GdkEventPrivate *private = (GdkEventPrivate *)event;
940 return private->screen;
943 if (event->any.window)
944 return gdk_drawable_get_screen (event->any.window);
950 * gdk_set_show_events:
951 * @show_events: %TRUE to output event debugging information.
953 * Sets whether a trace of received events is output.
954 * Note that GTK+ must be compiled with debugging (that is,
955 * configured using the <option>--enable-debug</option> option)
956 * to use this option.
959 gdk_set_show_events (gboolean show_events)
962 _gdk_debug_flags |= GDK_DEBUG_EVENTS;
964 _gdk_debug_flags &= ~GDK_DEBUG_EVENTS;
968 * gdk_get_show_events:
970 * Gets whether event debugging output is enabled.
972 * Return value: %TRUE if event debugging output is enabled.
975 gdk_get_show_events (void)
977 return (_gdk_debug_flags & GDK_DEBUG_EVENTS) != 0;
981 gdk_io_destroy (gpointer data)
983 GdkIOClosure *closure = data;
986 closure->notify (closure->data);
991 /* What do we do with G_IO_NVAL?
993 #define READ_CONDITION (G_IO_IN | G_IO_HUP | G_IO_ERR)
994 #define WRITE_CONDITION (G_IO_OUT | G_IO_ERR)
995 #define EXCEPTION_CONDITION (G_IO_PRI)
998 gdk_io_invoke (GIOChannel *source,
999 GIOCondition condition,
1002 GdkIOClosure *closure = data;
1003 GdkInputCondition gdk_cond = 0;
1005 if (condition & READ_CONDITION)
1006 gdk_cond |= GDK_INPUT_READ;
1007 if (condition & WRITE_CONDITION)
1008 gdk_cond |= GDK_INPUT_WRITE;
1009 if (condition & EXCEPTION_CONDITION)
1010 gdk_cond |= GDK_INPUT_EXCEPTION;
1012 if (closure->condition & gdk_cond)
1013 closure->function (closure->data, g_io_channel_unix_get_fd (source), gdk_cond);
1019 * gdk_input_add_full:
1020 * @source: a file descriptor.
1021 * @condition: the condition.
1022 * @function: the callback function.
1023 * @data: callback data passed to @function.
1024 * @destroy: callback function to call with @data when the input
1025 * handler is removed.
1027 * Establish a callback when a condition becomes true on
1028 * a file descriptor.
1030 * Returns: a tag that can later be used as an argument to
1031 * gdk_input_remove().
1033 * Deprecated: Use g_io_add_watch_full() on a #GIOChannel
1036 gdk_input_add_full (gint source,
1037 GdkInputCondition condition,
1038 GdkInputFunction function,
1040 GDestroyNotify destroy)
1043 GdkIOClosure *closure = g_new (GdkIOClosure, 1);
1044 GIOChannel *channel;
1045 GIOCondition cond = 0;
1047 closure->function = function;
1048 closure->condition = condition;
1049 closure->notify = destroy;
1050 closure->data = data;
1052 if (condition & GDK_INPUT_READ)
1053 cond |= READ_CONDITION;
1054 if (condition & GDK_INPUT_WRITE)
1055 cond |= WRITE_CONDITION;
1056 if (condition & GDK_INPUT_EXCEPTION)
1057 cond |= EXCEPTION_CONDITION;
1059 channel = g_io_channel_unix_new (source);
1060 result = g_io_add_watch_full (channel, G_PRIORITY_DEFAULT, cond,
1062 closure, gdk_io_destroy);
1063 g_io_channel_unref (channel);
1070 * @source: a file descriptor.
1071 * @condition: the condition.
1072 * @function: the callback function.
1073 * @data: callback data passed to @function.
1075 * Establish a callback when a condition becomes true on
1076 * a file descriptor.
1078 * Returns: a tag that can later be used as an argument to
1079 * gdk_input_remove().
1081 * Deprecated: Use g_io_add_watch() on a #GIOChannel
1084 gdk_input_add (gint source,
1085 GdkInputCondition condition,
1086 GdkInputFunction function,
1089 return gdk_input_add_full (source, condition, function, data, NULL);
1093 gdk_input_remove (gint tag)
1095 g_source_remove (tag);
1099 gdk_synthesize_click (GdkDisplay *display,
1103 GdkEvent temp_event;
1105 g_return_if_fail (event != NULL);
1107 temp_event = *event;
1108 temp_event.type = (nclicks == 2) ? GDK_2BUTTON_PRESS : GDK_3BUTTON_PRESS;
1110 gdk_display_put_event (display, &temp_event);
1114 _gdk_event_button_generate (GdkDisplay *display,
1117 if ((event->button.time < (display->button_click_time[1] + 2*display->double_click_time)) &&
1118 (event->button.window == display->button_window[1]) &&
1119 (event->button.button == display->button_number[1]) &&
1120 (ABS (event->button.x - display->button_x[1]) <= display->double_click_distance) &&
1121 (ABS (event->button.y - display->button_y[1]) <= display->double_click_distance))
1123 gdk_synthesize_click (display, event, 3);
1125 display->button_click_time[1] = 0;
1126 display->button_click_time[0] = 0;
1127 display->button_window[1] = NULL;
1128 display->button_window[0] = NULL;
1129 display->button_number[1] = -1;
1130 display->button_number[0] = -1;
1131 display->button_x[0] = display->button_x[1] = 0;
1132 display->button_y[0] = display->button_y[1] = 0;
1134 else if ((event->button.time < (display->button_click_time[0] + display->double_click_time)) &&
1135 (event->button.window == display->button_window[0]) &&
1136 (event->button.button == display->button_number[0]) &&
1137 (ABS (event->button.x - display->button_x[0]) <= display->double_click_distance) &&
1138 (ABS (event->button.y - display->button_y[0]) <= display->double_click_distance))
1140 gdk_synthesize_click (display, event, 2);
1142 display->button_click_time[1] = display->button_click_time[0];
1143 display->button_click_time[0] = event->button.time;
1144 display->button_window[1] = display->button_window[0];
1145 display->button_window[0] = event->button.window;
1146 display->button_number[1] = display->button_number[0];
1147 display->button_number[0] = event->button.button;
1148 display->button_x[1] = display->button_x[0];
1149 display->button_x[0] = event->button.x;
1150 display->button_y[1] = display->button_y[0];
1151 display->button_y[0] = event->button.y;
1155 display->button_click_time[1] = 0;
1156 display->button_click_time[0] = event->button.time;
1157 display->button_window[1] = NULL;
1158 display->button_window[0] = event->button.window;
1159 display->button_number[1] = -1;
1160 display->button_number[0] = event->button.button;
1161 display->button_x[1] = 0;
1162 display->button_x[0] = event->button.x;
1163 display->button_y[1] = 0;
1164 display->button_y[0] = event->button.y;
1169 gdk_synthesize_window_state (GdkWindow *window,
1170 GdkWindowState unset_flags,
1171 GdkWindowState set_flags)
1173 GdkEvent temp_event;
1176 g_return_if_fail (window != NULL);
1178 temp_event.window_state.window = window;
1179 temp_event.window_state.type = GDK_WINDOW_STATE;
1180 temp_event.window_state.send_event = FALSE;
1182 old = ((GdkWindowObject*) temp_event.window_state.window)->state;
1184 temp_event.window_state.new_window_state = old;
1185 temp_event.window_state.new_window_state |= set_flags;
1186 temp_event.window_state.new_window_state &= ~unset_flags;
1187 temp_event.window_state.changed_mask = temp_event.window_state.new_window_state ^ old;
1189 if (temp_event.window_state.new_window_state == old)
1190 return; /* No actual work to do, nothing changed. */
1192 /* Actually update the field in GdkWindow, this is sort of an odd
1193 * place to do it, but seems like the safest since it ensures we expose no
1194 * inconsistent state to the user.
1197 ((GdkWindowObject*) window)->state = temp_event.window_state.new_window_state;
1199 /* We only really send the event to toplevels, since
1200 * all the window states don't apply to non-toplevels.
1201 * Non-toplevels do use the GDK_WINDOW_STATE_WITHDRAWN flag
1202 * internally so we needed to update window->state.
1204 switch (((GdkWindowObject*) window)->window_type)
1206 case GDK_WINDOW_TOPLEVEL:
1207 case GDK_WINDOW_DIALOG:
1208 case GDK_WINDOW_TEMP: /* ? */
1209 gdk_display_put_event (gdk_drawable_get_display (window), &temp_event);
1212 case GDK_WINDOW_FOREIGN:
1213 case GDK_WINDOW_ROOT:
1214 case GDK_WINDOW_CHILD:
1220 * gdk_display_set_double_click_time:
1221 * @display: a #GdkDisplay
1222 * @msec: double click time in milliseconds (thousandths of a second)
1224 * Sets the double click time (two clicks within this time interval
1225 * count as a double click and result in a #GDK_2BUTTON_PRESS event).
1226 * Applications should <emphasis>not</emphasis> set this, it is a global
1227 * user-configured setting.
1232 gdk_display_set_double_click_time (GdkDisplay *display,
1235 display->double_click_time = msec;
1239 * gdk_set_double_click_time:
1240 * @msec: double click time in milliseconds (thousandths of a second)
1242 * Set the double click time for the default display. See
1243 * gdk_display_set_double_click_time().
1244 * See also gdk_display_set_double_click_distance().
1245 * Applications should <emphasis>not</emphasis> set this, it is a
1246 * global user-configured setting.
1249 gdk_set_double_click_time (guint msec)
1251 gdk_display_set_double_click_time (gdk_display_get_default (), msec);
1255 * gdk_display_set_double_click_distance:
1256 * @display: a #GdkDisplay
1257 * @distance: distance in pixels
1259 * Sets the double click distance (two clicks within this distance
1260 * count as a double click and result in a #GDK_2BUTTON_PRESS event).
1261 * See also gdk_display_set_double_click_time().
1262 * Applications should <emphasis>not</emphasis> set this, it is a global
1263 * user-configured setting.
1268 gdk_display_set_double_click_distance (GdkDisplay *display,
1271 display->double_click_distance = distance;
1275 gdk_event_get_type (void)
1277 static GType our_type = 0;
1280 our_type = g_boxed_type_register_static (g_intern_static_string ("GdkEvent"),
1281 (GBoxedCopyFunc)gdk_event_copy,
1282 (GBoxedFreeFunc)gdk_event_free);
1288 * @name: the name of the setting.
1289 * @value: location to store the value of the setting.
1291 * Obtains a desktop-wide setting, such as the double-click time,
1292 * for the default screen. See gdk_screen_get_setting().
1294 * Returns: %TRUE if the setting existed and a value was stored
1295 * in @value, %FALSE otherwise.
1298 gdk_setting_get (const gchar *name,
1301 return gdk_screen_get_setting (gdk_screen_get_default (), name, value);
1304 #define __GDK_EVENTS_C__
1305 #include "gdkaliasdef.c"