Method

GdkWindowget_geometry

Declaration [src]

void
gdk_window_get_geometry (
  GdkWindow* window,
  gint* x,
  gint* y,
  gint* width,
  gint* height
)

Description [src]

Any of the return location arguments to this function may be NULL, if you aren’t interested in getting the value of that field.

The X and Y coordinates returned are relative to the parent window of window, which for toplevels usually means relative to the window decorations (titlebar, etc.) rather than relative to the root window (screen-size background window).

On the X11 platform, the geometry is obtained from the X server, so reflects the latest position of window; this may be out-of-sync with the position of window delivered in the most-recently-processed 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 much better to call gdk_window_get_position(), gdk_window_get_width() and gdk_window_get_height() instead, because it avoids the roundtrip to the X server and because these functions support the full 32-bit coordinate space, whereas gdk_window_get_geometry() is restricted to the 16-bit coordinates of X11.

Parameters

x

Type: gint*

Return location for X coordinate of window (relative to its parent)

The argument will be set by the function.

The argument can be NULL.

y

Type: gint*

Return location for Y coordinate of window (relative to its parent)

The argument will be set by the function.

The argument can be NULL.

width

Type: gint*

Return location for width of window.

The argument will be set by the function.

The argument can be NULL.

height

Type: gint*

Return location for height of window.

The argument will be set by the function.

The argument can be NULL.