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_insert_after:
125 * @display: a #GdkDisplay
126 * @sibling: Append after this event.
127 * @event: Event to append.
129 * Appends an event after the specified event, or if it isn't in
130 * the queue, onto the tail of the event queue.
132 * Returns: the newly appended list node.
137 _gdk_event_queue_insert_after (GdkDisplay *display,
141 GList *prev = g_list_find (display->queued_events, sibling);
142 if (prev && prev->next)
144 display->queued_events = g_list_insert_before (display->queued_events, prev->next, event);
148 return _gdk_event_queue_append (display, event);
152 * _gdk_event_queue_insert_after:
153 * @display: a #GdkDisplay
154 * @sibling: Append after this event.
155 * @event: Event to append.
157 * Appends an event before the specified event, or if it isn't in
158 * the queue, onto the tail of the event queue.
160 * Returns: the newly appended list node.
165 _gdk_event_queue_insert_before (GdkDisplay *display,
169 GList *next = g_list_find (display->queued_events, sibling);
172 display->queued_events = g_list_insert_before (display->queued_events, next, event);
176 return _gdk_event_queue_append (display, event);
181 * _gdk_event_queue_remove_link:
182 * @display: a #GdkDisplay
183 * @node: node to remove
185 * Removes a specified list node from the event queue.
188 _gdk_event_queue_remove_link (GdkDisplay *display,
192 node->prev->next = node->next;
194 display->queued_events = node->next;
197 node->next->prev = node->prev;
199 display->queued_tail = node->prev;
203 * _gdk_event_unqueue:
204 * @display: a #GdkDisplay
206 * Removes and returns the first event from the event
207 * queue that is not still being filled in.
209 * Return value: the event, or %NULL. Ownership is transferred
213 _gdk_event_unqueue (GdkDisplay *display)
215 GdkEvent *event = NULL;
218 tmp_list = _gdk_event_queue_find_first (display);
222 event = tmp_list->data;
223 _gdk_event_queue_remove_link (display, tmp_list);
224 g_list_free_1 (tmp_list);
231 * gdk_event_handler_set:
232 * @func: the function to call to handle events from GDK.
233 * @data: user data to pass to the function.
234 * @notify: the function to call when the handler function is removed, i.e. when
235 * gdk_event_handler_set() is called with another event handler.
237 * Sets the function to call to handle all events from GDK.
239 * Note that GTK+ uses this to install its own event handler, so it is
240 * usually not useful for GTK+ applications. (Although an application
241 * can call this function then call gtk_main_do_event() to pass
245 gdk_event_handler_set (GdkEventFunc func,
247 GDestroyNotify notify)
249 if (_gdk_event_notify)
250 (*_gdk_event_notify) (_gdk_event_data);
252 _gdk_event_func = func;
253 _gdk_event_data = data;
254 _gdk_event_notify = notify;
260 * Checks all open displays for a #GdkEvent to process,to be processed
261 * on, fetching events from the windowing system if necessary.
262 * See gdk_display_get_event().
264 * Return value: the next #GdkEvent to be processed, or %NULL if no events
265 * are pending. The returned #GdkEvent should be freed with gdk_event_free().
272 for (tmp_list = _gdk_displays; tmp_list; tmp_list = tmp_list->next)
274 GdkEvent *event = gdk_display_get_event (tmp_list->data);
285 * If there is an event waiting in the event queue of some open
286 * display, returns a copy of it. See gdk_display_peek_event().
288 * Return value: a copy of the first #GdkEvent on some event queue, or %NULL if no
289 * events are in any queues. The returned #GdkEvent should be freed with
293 gdk_event_peek (void)
297 for (tmp_list = _gdk_displays; tmp_list; tmp_list = tmp_list->next)
299 GdkEvent *event = gdk_display_peek_event (tmp_list->data);
309 * @event: a #GdkEvent.
311 * Appends a copy of the given event onto the front of the event
312 * queue for event->any.window's display, or the default event
313 * queue if event->any.window is %NULL. See gdk_display_put_event().
316 gdk_event_put (const GdkEvent *event)
320 g_return_if_fail (event != NULL);
322 if (event->any.window)
323 display = gdk_drawable_get_display (event->any.window);
327 g_message ("Falling back to default display for gdk_event_put()"));
328 display = gdk_display_get_default ();
331 gdk_display_put_event (display, event);
334 static GHashTable *event_hash = NULL;
338 * @type: a #GdkEventType
340 * Creates a new event of the given type. All fields are set to 0.
342 * Return value: a newly-allocated #GdkEvent. The returned #GdkEvent
343 * should be freed with gdk_event_free().
348 gdk_event_new (GdkEventType type)
350 GdkEventPrivate *new_private;
354 event_hash = g_hash_table_new (g_direct_hash, NULL);
356 new_private = g_slice_new0 (GdkEventPrivate);
358 new_private->flags = 0;
359 new_private->screen = NULL;
361 g_hash_table_insert (event_hash, new_private, GUINT_TO_POINTER (1));
363 new_event = (GdkEvent *) new_private;
365 new_event->any.type = type;
368 * Bytewise 0 initialization is reasonable for most of the
369 * current event types. Explicitely initialize double fields
370 * since I trust bytewise 0 == 0. less than for integers
375 case GDK_MOTION_NOTIFY:
376 new_event->motion.x = 0.;
377 new_event->motion.y = 0.;
378 new_event->motion.x_root = 0.;
379 new_event->motion.y_root = 0.;
381 case GDK_BUTTON_PRESS:
382 case GDK_2BUTTON_PRESS:
383 case GDK_3BUTTON_PRESS:
384 case GDK_BUTTON_RELEASE:
385 new_event->button.x = 0.;
386 new_event->button.y = 0.;
387 new_event->button.x_root = 0.;
388 new_event->button.y_root = 0.;
391 new_event->scroll.x = 0.;
392 new_event->scroll.y = 0.;
393 new_event->scroll.x_root = 0.;
394 new_event->scroll.y_root = 0.;
396 case GDK_ENTER_NOTIFY:
397 case GDK_LEAVE_NOTIFY:
398 new_event->crossing.x = 0.;
399 new_event->crossing.y = 0.;
400 new_event->crossing.x_root = 0.;
401 new_event->crossing.y_root = 0.;
411 gdk_event_is_allocated (const GdkEvent *event)
414 return g_hash_table_lookup (event_hash, event) != NULL;
421 * @event: a #GdkEvent
423 * Copies a #GdkEvent, copying or incrementing the reference count of the
424 * resources associated with it (e.g. #GdkWindow's and strings).
426 * Return value: a copy of @event. The returned #GdkEvent should be freed with
430 gdk_event_copy (const GdkEvent *event)
432 GdkEventPrivate *new_private;
435 g_return_val_if_fail (event != NULL, NULL);
437 new_event = gdk_event_new (GDK_NOTHING);
438 new_private = (GdkEventPrivate *)new_event;
441 if (new_event->any.window)
442 g_object_ref (new_event->any.window);
444 if (gdk_event_is_allocated (event))
446 GdkEventPrivate *private = (GdkEventPrivate *)event;
448 new_private->screen = private->screen;
451 switch (event->any.type)
454 case GDK_KEY_RELEASE:
455 new_event->key.string = g_strdup (event->key.string);
458 case GDK_ENTER_NOTIFY:
459 case GDK_LEAVE_NOTIFY:
460 if (event->crossing.subwindow != NULL)
461 g_object_ref (event->crossing.subwindow);
466 case GDK_DRAG_MOTION:
467 case GDK_DRAG_STATUS:
469 case GDK_DROP_FINISHED:
470 g_object_ref (event->dnd.context);
474 if (event->expose.region)
475 new_event->expose.region = gdk_region_copy (event->expose.region);
479 new_event->setting.name = g_strdup (new_event->setting.name);
482 case GDK_BUTTON_PRESS:
483 case GDK_BUTTON_RELEASE:
484 if (event->button.axes)
485 new_event->button.axes = g_memdup (event->button.axes,
486 sizeof (gdouble) * event->button.device->num_axes);
489 case GDK_MOTION_NOTIFY:
490 if (event->motion.axes)
491 new_event->motion.axes = g_memdup (event->motion.axes,
492 sizeof (gdouble) * event->motion.device->num_axes);
500 if (gdk_event_is_allocated (event))
501 _gdk_windowing_event_data_copy (event, new_event);
508 * @event: a #GdkEvent.
510 * Frees a #GdkEvent, freeing or decrementing any resources associated with it.
511 * Note that this function should only be called with events returned from
512 * functions such as gdk_event_peek(), gdk_event_get(),
513 * gdk_event_get_graphics_expose() and gdk_event_copy().
516 gdk_event_free (GdkEvent *event)
518 g_return_if_fail (event != NULL);
520 if (event->any.window)
521 g_object_unref (event->any.window);
523 switch (event->any.type)
526 case GDK_KEY_RELEASE:
527 g_free (event->key.string);
530 case GDK_ENTER_NOTIFY:
531 case GDK_LEAVE_NOTIFY:
532 if (event->crossing.subwindow != NULL)
533 g_object_unref (event->crossing.subwindow);
538 case GDK_DRAG_MOTION:
539 case GDK_DRAG_STATUS:
541 case GDK_DROP_FINISHED:
542 g_object_unref (event->dnd.context);
545 case GDK_BUTTON_PRESS:
546 case GDK_BUTTON_RELEASE:
547 g_free (event->button.axes);
551 if (event->expose.region)
552 gdk_region_destroy (event->expose.region);
555 case GDK_MOTION_NOTIFY:
556 g_free (event->motion.axes);
560 g_free (event->setting.name);
567 _gdk_windowing_event_data_free (event);
569 g_hash_table_remove (event_hash, event);
570 g_slice_free (GdkEventPrivate, (GdkEventPrivate*) event);
574 * gdk_event_get_time:
575 * @event: a #GdkEvent
577 * Returns the time stamp from @event, if there is one; otherwise
578 * returns #GDK_CURRENT_TIME. If @event is %NULL, returns #GDK_CURRENT_TIME.
580 * Return value: time stamp field from @event
583 gdk_event_get_time (const GdkEvent *event)
588 case GDK_MOTION_NOTIFY:
589 return event->motion.time;
590 case GDK_BUTTON_PRESS:
591 case GDK_2BUTTON_PRESS:
592 case GDK_3BUTTON_PRESS:
593 case GDK_BUTTON_RELEASE:
594 return event->button.time;
596 return event->scroll.time;
598 case GDK_KEY_RELEASE:
599 return event->key.time;
600 case GDK_ENTER_NOTIFY:
601 case GDK_LEAVE_NOTIFY:
602 return event->crossing.time;
603 case GDK_PROPERTY_NOTIFY:
604 return event->property.time;
605 case GDK_SELECTION_CLEAR:
606 case GDK_SELECTION_REQUEST:
607 case GDK_SELECTION_NOTIFY:
608 return event->selection.time;
609 case GDK_PROXIMITY_IN:
610 case GDK_PROXIMITY_OUT:
611 return event->proximity.time;
614 case GDK_DRAG_MOTION:
615 case GDK_DRAG_STATUS:
617 case GDK_DROP_FINISHED:
618 return event->dnd.time;
619 case GDK_CLIENT_EVENT:
620 case GDK_VISIBILITY_NOTIFY:
623 case GDK_FOCUS_CHANGE:
631 case GDK_WINDOW_STATE:
633 case GDK_OWNER_CHANGE:
634 case GDK_GRAB_BROKEN:
635 /* return current time */
639 return GDK_CURRENT_TIME;
643 * gdk_event_get_state:
644 * @event: a #GdkEvent or NULL
645 * @state: return location for state
647 * If the event contains a "state" field, puts that field in @state. Otherwise
648 * stores an empty state (0). Returns %TRUE if there was a state field
649 * in the event. @event may be %NULL, in which case it's treated
650 * as if the event had no state field.
652 * Return value: %TRUE if there was a state field in the event
655 gdk_event_get_state (const GdkEvent *event,
656 GdkModifierType *state)
658 g_return_val_if_fail (state != NULL, FALSE);
663 case GDK_MOTION_NOTIFY:
664 *state = event->motion.state;
666 case GDK_BUTTON_PRESS:
667 case GDK_2BUTTON_PRESS:
668 case GDK_3BUTTON_PRESS:
669 case GDK_BUTTON_RELEASE:
670 *state = event->button.state;
673 *state = event->scroll.state;
676 case GDK_KEY_RELEASE:
677 *state = event->key.state;
679 case GDK_ENTER_NOTIFY:
680 case GDK_LEAVE_NOTIFY:
681 *state = event->crossing.state;
683 case GDK_PROPERTY_NOTIFY:
684 *state = event->property.state;
686 case GDK_VISIBILITY_NOTIFY:
687 case GDK_CLIENT_EVENT:
690 case GDK_FOCUS_CHANGE:
691 case GDK_SELECTION_CLEAR:
692 case GDK_SELECTION_REQUEST:
693 case GDK_SELECTION_NOTIFY:
694 case GDK_PROXIMITY_IN:
695 case GDK_PROXIMITY_OUT:
699 case GDK_DRAG_MOTION:
700 case GDK_DRAG_STATUS:
702 case GDK_DROP_FINISHED:
709 case GDK_WINDOW_STATE:
711 case GDK_OWNER_CHANGE:
712 case GDK_GRAB_BROKEN:
722 * gdk_event_get_coords:
723 * @event: a #GdkEvent
724 * @x_win: location to put event window x coordinate
725 * @y_win: location to put event window y coordinate
727 * Extract the event window relative x/y coordinates from an event.
729 * Return value: %TRUE if the event delivered event window coordinates
732 gdk_event_get_coords (const GdkEvent *event,
736 gdouble x = 0, y = 0;
737 gboolean fetched = TRUE;
739 g_return_val_if_fail (event != NULL, FALSE);
744 x = event->configure.x;
745 y = event->configure.y;
747 case GDK_ENTER_NOTIFY:
748 case GDK_LEAVE_NOTIFY:
749 x = event->crossing.x;
750 y = event->crossing.y;
756 case GDK_BUTTON_PRESS:
757 case GDK_2BUTTON_PRESS:
758 case GDK_3BUTTON_PRESS:
759 case GDK_BUTTON_RELEASE:
763 case GDK_MOTION_NOTIFY:
781 * gdk_event_get_root_coords:
782 * @event: a #GdkEvent
783 * @x_root: location to put root window x coordinate
784 * @y_root: location to put root window y coordinate
786 * Extract the root window relative x/y coordinates from an event.
788 * Return value: %TRUE if the event delivered root window coordinates
791 gdk_event_get_root_coords (const GdkEvent *event,
795 gdouble x = 0, y = 0;
796 gboolean fetched = TRUE;
798 g_return_val_if_fail (event != NULL, FALSE);
802 case GDK_MOTION_NOTIFY:
803 x = event->motion.x_root;
804 y = event->motion.y_root;
807 x = event->scroll.x_root;
808 y = event->scroll.y_root;
810 case GDK_BUTTON_PRESS:
811 case GDK_2BUTTON_PRESS:
812 case GDK_3BUTTON_PRESS:
813 case GDK_BUTTON_RELEASE:
814 x = event->button.x_root;
815 y = event->button.y_root;
817 case GDK_ENTER_NOTIFY:
818 case GDK_LEAVE_NOTIFY:
819 x = event->crossing.x_root;
820 y = event->crossing.y_root;
824 case GDK_DRAG_MOTION:
825 case GDK_DRAG_STATUS:
827 case GDK_DROP_FINISHED:
828 x = event->dnd.x_root;
829 y = event->dnd.y_root;
845 * gdk_event_get_axis:
846 * @event: a #GdkEvent
847 * @axis_use: the axis use to look for
848 * @value: location to store the value found
850 * Extract the axis value for a particular axis use from
851 * an event structure.
853 * Return value: %TRUE if the specified axis was found, otherwise %FALSE
856 gdk_event_get_axis (const GdkEvent *event,
863 g_return_val_if_fail (event != NULL, FALSE);
865 if (axis_use == GDK_AXIS_X || axis_use == GDK_AXIS_Y)
871 case GDK_MOTION_NOTIFY:
879 case GDK_BUTTON_PRESS:
880 case GDK_BUTTON_RELEASE:
884 case GDK_ENTER_NOTIFY:
885 case GDK_LEAVE_NOTIFY:
886 x = event->crossing.x;
887 y = event->crossing.y;
894 if (axis_use == GDK_AXIS_X && value)
896 if (axis_use == GDK_AXIS_Y && value)
901 else if (event->type == GDK_BUTTON_PRESS ||
902 event->type == GDK_BUTTON_RELEASE)
904 device = event->button.device;
905 axes = event->button.axes;
907 else if (event->type == GDK_MOTION_NOTIFY)
909 device = event->motion.device;
910 axes = event->motion.axes;
915 return gdk_device_get_axis (device, axes, axis_use, value);
919 * gdk_event_request_motions:
920 * @event: a valid #GdkEvent
922 * Request more motion notifies if @event is a motion notify hint event.
923 * This function should be used instead of gdk_window_get_pointer() to
924 * request further motion notifies, because it also works for extension
925 * events where motion notifies are provided for devices other than the
926 * core pointer. Coordinate extraction, processing and requesting more
927 * motion events from a %GDK_MOTION_NOTIFY event usually works like this:
931 * /* motion_event handler */
932 * x = motion_event->x;
933 * y = motion_event->y;
934 * /* handle (x,y) motion */
935 * gdk_event_request_motions (motion_event); /* handles is_hint events */
942 gdk_event_request_motions (const GdkEventMotion *event)
944 g_return_if_fail (event != NULL);
945 if (event->type == GDK_MOTION_NOTIFY && event->is_hint)
946 gdk_device_get_state (event->device, event->window, NULL, NULL);
950 * gdk_event_set_screen:
951 * @event: a #GdkEvent
952 * @screen: a #GdkScreen
954 * Sets the screen for @event to @screen. The event must
955 * have been allocated by GTK+, for instance, by
961 gdk_event_set_screen (GdkEvent *event,
964 GdkEventPrivate *private;
966 g_return_if_fail (gdk_event_is_allocated (event));
968 private = (GdkEventPrivate *)event;
970 private->screen = screen;
974 * gdk_event_get_screen:
975 * @event: a #GdkEvent
977 * Returns the screen for the event. The screen is
978 * typically the screen for <literal>event->any.window</literal>, but
979 * for events such as mouse events, it is the screen
980 * where the pointer was when the event occurs -
981 * that is, the screen which has the root window
982 * to which <literal>event->motion.x_root</literal> and
983 * <literal>event->motion.y_root</literal> are relative.
985 * Return value: the screen for the event
990 gdk_event_get_screen (const GdkEvent *event)
992 if (gdk_event_is_allocated (event))
994 GdkEventPrivate *private = (GdkEventPrivate *)event;
997 return private->screen;
1000 if (event->any.window)
1001 return gdk_drawable_get_screen (event->any.window);
1007 * gdk_set_show_events:
1008 * @show_events: %TRUE to output event debugging information.
1010 * Sets whether a trace of received events is output.
1011 * Note that GTK+ must be compiled with debugging (that is,
1012 * configured using the <option>--enable-debug</option> option)
1013 * to use this option.
1016 gdk_set_show_events (gboolean show_events)
1019 _gdk_debug_flags |= GDK_DEBUG_EVENTS;
1021 _gdk_debug_flags &= ~GDK_DEBUG_EVENTS;
1025 * gdk_get_show_events:
1027 * Gets whether event debugging output is enabled.
1029 * Return value: %TRUE if event debugging output is enabled.
1032 gdk_get_show_events (void)
1034 return (_gdk_debug_flags & GDK_DEBUG_EVENTS) != 0;
1038 gdk_io_destroy (gpointer data)
1040 GdkIOClosure *closure = data;
1042 if (closure->notify)
1043 closure->notify (closure->data);
1048 /* What do we do with G_IO_NVAL?
1050 #define READ_CONDITION (G_IO_IN | G_IO_HUP | G_IO_ERR)
1051 #define WRITE_CONDITION (G_IO_OUT | G_IO_ERR)
1052 #define EXCEPTION_CONDITION (G_IO_PRI)
1055 gdk_io_invoke (GIOChannel *source,
1056 GIOCondition condition,
1059 GdkIOClosure *closure = data;
1060 GdkInputCondition gdk_cond = 0;
1062 if (condition & READ_CONDITION)
1063 gdk_cond |= GDK_INPUT_READ;
1064 if (condition & WRITE_CONDITION)
1065 gdk_cond |= GDK_INPUT_WRITE;
1066 if (condition & EXCEPTION_CONDITION)
1067 gdk_cond |= GDK_INPUT_EXCEPTION;
1069 if (closure->condition & gdk_cond)
1070 closure->function (closure->data, g_io_channel_unix_get_fd (source), gdk_cond);
1076 * gdk_input_add_full:
1077 * @source: a file descriptor.
1078 * @condition: the condition.
1079 * @function: the callback function.
1080 * @data: callback data passed to @function.
1081 * @destroy: callback function to call with @data when the input
1082 * handler is removed.
1084 * Establish a callback when a condition becomes true on
1085 * a file descriptor.
1087 * Returns: a tag that can later be used as an argument to
1088 * gdk_input_remove().
1090 * Deprecated: Use g_io_add_watch_full() on a #GIOChannel
1093 gdk_input_add_full (gint source,
1094 GdkInputCondition condition,
1095 GdkInputFunction function,
1097 GDestroyNotify destroy)
1100 GdkIOClosure *closure = g_new (GdkIOClosure, 1);
1101 GIOChannel *channel;
1102 GIOCondition cond = 0;
1104 closure->function = function;
1105 closure->condition = condition;
1106 closure->notify = destroy;
1107 closure->data = data;
1109 if (condition & GDK_INPUT_READ)
1110 cond |= READ_CONDITION;
1111 if (condition & GDK_INPUT_WRITE)
1112 cond |= WRITE_CONDITION;
1113 if (condition & GDK_INPUT_EXCEPTION)
1114 cond |= EXCEPTION_CONDITION;
1116 channel = g_io_channel_unix_new (source);
1117 result = g_io_add_watch_full (channel, G_PRIORITY_DEFAULT, cond,
1119 closure, gdk_io_destroy);
1120 g_io_channel_unref (channel);
1127 * @source: a file descriptor.
1128 * @condition: the condition.
1129 * @function: the callback function.
1130 * @data: callback data passed to @function.
1132 * Establish a callback when a condition becomes true on
1133 * a file descriptor.
1135 * Returns: a tag that can later be used as an argument to
1136 * gdk_input_remove().
1138 * Deprecated: Use g_io_add_watch() on a #GIOChannel
1141 gdk_input_add (gint source,
1142 GdkInputCondition condition,
1143 GdkInputFunction function,
1146 return gdk_input_add_full (source, condition, function, data, NULL);
1150 gdk_input_remove (gint tag)
1152 g_source_remove (tag);
1156 gdk_synthesize_click (GdkDisplay *display,
1160 GdkEvent temp_event;
1161 GdkEvent *event_copy;
1164 g_return_if_fail (event != NULL);
1166 temp_event = *event;
1167 temp_event.type = (nclicks == 2) ? GDK_2BUTTON_PRESS : GDK_3BUTTON_PRESS;
1169 event_copy = gdk_event_copy (&temp_event);
1170 link = _gdk_event_queue_append (display, event_copy);
1174 _gdk_event_button_generate (GdkDisplay *display,
1177 if ((event->button.time < (display->button_click_time[1] + 2*display->double_click_time)) &&
1178 (event->button.window == display->button_window[1]) &&
1179 (event->button.button == display->button_number[1]) &&
1180 (ABS (event->button.x - display->button_x[1]) <= display->double_click_distance) &&
1181 (ABS (event->button.y - display->button_y[1]) <= display->double_click_distance))
1183 gdk_synthesize_click (display, event, 3);
1185 display->button_click_time[1] = 0;
1186 display->button_click_time[0] = 0;
1187 display->button_window[1] = NULL;
1188 display->button_window[0] = NULL;
1189 display->button_number[1] = -1;
1190 display->button_number[0] = -1;
1191 display->button_x[0] = display->button_x[1] = 0;
1192 display->button_y[0] = display->button_y[1] = 0;
1194 else if ((event->button.time < (display->button_click_time[0] + display->double_click_time)) &&
1195 (event->button.window == display->button_window[0]) &&
1196 (event->button.button == display->button_number[0]) &&
1197 (ABS (event->button.x - display->button_x[0]) <= display->double_click_distance) &&
1198 (ABS (event->button.y - display->button_y[0]) <= display->double_click_distance))
1200 gdk_synthesize_click (display, event, 2);
1202 display->button_click_time[1] = display->button_click_time[0];
1203 display->button_click_time[0] = event->button.time;
1204 display->button_window[1] = display->button_window[0];
1205 display->button_window[0] = event->button.window;
1206 display->button_number[1] = display->button_number[0];
1207 display->button_number[0] = event->button.button;
1208 display->button_x[1] = display->button_x[0];
1209 display->button_x[0] = event->button.x;
1210 display->button_y[1] = display->button_y[0];
1211 display->button_y[0] = event->button.y;
1215 display->button_click_time[1] = 0;
1216 display->button_click_time[0] = event->button.time;
1217 display->button_window[1] = NULL;
1218 display->button_window[0] = event->button.window;
1219 display->button_number[1] = -1;
1220 display->button_number[0] = event->button.button;
1221 display->button_x[1] = 0;
1222 display->button_x[0] = event->button.x;
1223 display->button_y[1] = 0;
1224 display->button_y[0] = event->button.y;
1229 gdk_synthesize_window_state (GdkWindow *window,
1230 GdkWindowState unset_flags,
1231 GdkWindowState set_flags)
1233 GdkEvent temp_event;
1236 g_return_if_fail (window != NULL);
1238 temp_event.window_state.window = window;
1239 temp_event.window_state.type = GDK_WINDOW_STATE;
1240 temp_event.window_state.send_event = FALSE;
1242 old = ((GdkWindowObject*) temp_event.window_state.window)->state;
1244 temp_event.window_state.new_window_state = old;
1245 temp_event.window_state.new_window_state |= set_flags;
1246 temp_event.window_state.new_window_state &= ~unset_flags;
1247 temp_event.window_state.changed_mask = temp_event.window_state.new_window_state ^ old;
1249 if (temp_event.window_state.new_window_state == old)
1250 return; /* No actual work to do, nothing changed. */
1252 /* Actually update the field in GdkWindow, this is sort of an odd
1253 * place to do it, but seems like the safest since it ensures we expose no
1254 * inconsistent state to the user.
1257 ((GdkWindowObject*) window)->state = temp_event.window_state.new_window_state;
1259 /* We only really send the event to toplevels, since
1260 * all the window states don't apply to non-toplevels.
1261 * Non-toplevels do use the GDK_WINDOW_STATE_WITHDRAWN flag
1262 * internally so we needed to update window->state.
1264 switch (((GdkWindowObject*) window)->window_type)
1266 case GDK_WINDOW_TOPLEVEL:
1267 case GDK_WINDOW_DIALOG:
1268 case GDK_WINDOW_TEMP: /* ? */
1269 gdk_display_put_event (gdk_drawable_get_display (window), &temp_event);
1272 case GDK_WINDOW_FOREIGN:
1273 case GDK_WINDOW_ROOT:
1274 case GDK_WINDOW_CHILD:
1280 * gdk_display_set_double_click_time:
1281 * @display: a #GdkDisplay
1282 * @msec: double click time in milliseconds (thousandths of a second)
1284 * Sets the double click time (two clicks within this time interval
1285 * count as a double click and result in a #GDK_2BUTTON_PRESS event).
1286 * Applications should <emphasis>not</emphasis> set this, it is a global
1287 * user-configured setting.
1292 gdk_display_set_double_click_time (GdkDisplay *display,
1295 display->double_click_time = msec;
1299 * gdk_set_double_click_time:
1300 * @msec: double click time in milliseconds (thousandths of a second)
1302 * Set the double click time for the default display. See
1303 * gdk_display_set_double_click_time().
1304 * See also gdk_display_set_double_click_distance().
1305 * Applications should <emphasis>not</emphasis> set this, it is a
1306 * global user-configured setting.
1309 gdk_set_double_click_time (guint msec)
1311 gdk_display_set_double_click_time (gdk_display_get_default (), msec);
1315 * gdk_display_set_double_click_distance:
1316 * @display: a #GdkDisplay
1317 * @distance: distance in pixels
1319 * Sets the double click distance (two clicks within this distance
1320 * count as a double click and result in a #GDK_2BUTTON_PRESS event).
1321 * See also gdk_display_set_double_click_time().
1322 * Applications should <emphasis>not</emphasis> set this, it is a global
1323 * user-configured setting.
1328 gdk_display_set_double_click_distance (GdkDisplay *display,
1331 display->double_click_distance = distance;
1335 gdk_event_get_type (void)
1337 static GType our_type = 0;
1340 our_type = g_boxed_type_register_static (g_intern_static_string ("GdkEvent"),
1341 (GBoxedCopyFunc)gdk_event_copy,
1342 (GBoxedFreeFunc)gdk_event_free);
1348 * @name: the name of the setting.
1349 * @value: location to store the value of the setting.
1351 * Obtains a desktop-wide setting, such as the double-click time,
1352 * for the default screen. See gdk_screen_get_setting().
1354 * Returns: %TRUE if the setting existed and a value was stored
1355 * in @value, %FALSE otherwise.
1358 gdk_setting_get (const gchar *name,
1361 return gdk_screen_get_setting (gdk_screen_get_default (), name, value);
1364 #define __GDK_EVENTS_C__
1365 #include "gdkaliasdef.c"