From 52c134e00782a39d529f02867ab9e28705cc6e40 Mon Sep 17 00:00:00 2001 From: Tim Janik Date: Wed, 4 Jul 2007 10:21:05 +0000 Subject: [PATCH] added usage example to gdk_event_request_motions() docs. Wed Jul 4 12:20:23 2007 Tim Janik * gdk/gdkevents.c (gdk_event_request_motions): added usage example to gdk_event_request_motions() docs. svn path=/trunk/; revision=18378 --- ChangeLog | 5 +++++ gdk/gdkevents.c | 12 +++++++++++- 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/ChangeLog b/ChangeLog index 02273abbbb..4eb7f5cf23 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +Wed Jul 4 12:20:23 2007 Tim Janik + + * gdk/gdkevents.c (gdk_event_request_motions): added usage example + to gdk_event_request_motions() docs. + 2007-07-04 Tor Lillqvist * gtk/gtkstatusicon.c: On Win32 call diff --git a/gdk/gdkevents.c b/gdk/gdkevents.c index 40998e79fd..1c58aadc89 100644 --- a/gdk/gdkevents.c +++ b/gdk/gdkevents.c @@ -840,7 +840,17 @@ gdk_event_get_axis (GdkEvent *event, * This function should be used instead of gdk_window_get_pointer() to * request further motion notifies, because it also works for extension * events where motion notifies are provided for devices other than the - * core pointer. + * core pointer. Coordinate extraction, processing and requesting more + * motion events from a %GDK_MOTION_NOTIFY event usually works like this: + * + * + * { // motion_event handler + * x = motion_event->x; + * y = motion_event->y; + * ; // handle (x,y) motion + * gdk_event_request_motions (motion_event); // handles is_hint events + * } + * * * Since: 2.12 **/