summaryrefslogtreecommitdiff
path: root/gdk
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2004-11-09 20:10:23 +0000
committerMatthias Clasen <matthiasc@src.gnome.org>2004-11-09 20:10:23 +0000
commit494a2271a2bea78866343d9f8d8be52375ff5157 (patch)
tree619b7e5095f056200cd085f9f2265fd56063eb22 /gdk
parent16912474cc0f0b392978e99b30c0be45dc767584 (diff)
downloadgdk-pixbuf-494a2271a2bea78866343d9f8d8be52375ff5157.tar.gz
Add a hint about using gdk_drawable_get_size() instead.
2004-11-09 Matthias Clasen <mclasen@redhat.com> * gdk/x11/gdkwindow-x11.c (gdk_window_get_geometry): Add a hint about using gdk_drawable_get_size() instead.
Diffstat (limited to 'gdk')
-rw-r--r--gdk/x11/gdkwindow-x11.c8
1 files changed, 8 insertions, 0 deletions
diff --git a/gdk/x11/gdkwindow-x11.c b/gdk/x11/gdkwindow-x11.c
index d6dfda7df..f5da16fcc 100644
--- a/gdk/x11/gdkwindow-x11.c
+++ b/gdk/x11/gdkwindow-x11.c
@@ -2899,6 +2899,14 @@ gdk_window_set_cursor (GdkWindow *window,
* #GdkEventConfigure. gdk_window_get_position() in contrast gets the
* position from the most recent configure event.
*
+ * <note>
+ * If @window is not a toplevel, it is <emphasis>much</emphasis> better
+ * to call gdk_window_get_position() and gdk_drawable_get_size() instead,
+ * because it avoids the roundtrip to the X server and because
+ * gdk_drawable_get_size() supports the full 32-bit coordinate space,
+ * whereas gdk_window_get_geometry() is restricted to the 16-bit
+ * coordinates of X11.
+ *</note>
**/
void
gdk_window_get_geometry (GdkWindow *window,