docs: Add docs about how to get a GtkDevice

Fixes https://bugzilla.gnome.org/show_bug.cgi?id=637895
This commit is contained in:
Javier Jardón 2010-12-24 14:39:55 +01:00
parent 55ca24d1d4
commit 30cdab13fe

View File

@ -1044,7 +1044,10 @@ get_native_grab_event_mask (GdkEventMask grab_mask)
/**
* gdk_device_grab:
* @device: a #GdkDevice
* @device: a #GdkDevice. To get the device you can use gtk_get_current_event_device()
* or gdk_event_get_device() if the grab is in reaction to an event. Also, you can use
* gdk_device_manager_get_client_pointer() but only in code that isn't triggered by a
* #GdkEvent and there aren't other means to get a meaningful #GdkDevice to operate on.
* @window: the #GdkWindow which will own the grab (the grab window)
* @grab_ownership: specifies the grab ownership.
* @owner_events: if %FALSE then all device events are reported with respect to