XGetWindowAttributes(3X11)

Name

XGetWindowAttributes, XGetGeometry − get current window attribute or geometry

Syntax

Status XGetWindowAttributes(display, w, window_attributes_return)
      Display *display;
      Window w;
      XWindowAttributes *window_attributes_return;

Status XGetGeometry(display, d, root_return, x_return, y_return, width_return, height_return, border_width_return, depth_return)
        Display *display;
        Drawable d;
        Window *root_return;
        int *x_return, *y_return;
        unsigned int *width_return, *height_return;
        unsigned int *border_width_return;
        unsigned int *depth_return;

Arguments

border_width_return
Returns the border width in pixels.

dSpecifies the drawable, which can be a window or a pixmap.

depth_returnReturns the depth of the drawable (bits per pixel for the object).

displaySpecifies the connection to the X server.

root_returnReturns the root window.

wSpecifies the window whose current attributes you want to obtain.

width_return

height_return
Return the drawable’s dimensions (width and height).

window_attributes_return
Returns the specified window’s attributes in the XWindowAttributes structure.

x_return

y_returnReturn the x and y coordinates that define the location of the drawable. For a window, these coordinates specify the upper-left outer corner relative to its parent’s origin. For pixmaps, these coordinates are always zero.

Description

The XGetWindowAttributes function returns the current attributes for the specified window to an XWindowAttributes structure.

XGetWindowAttributes can generate BadDrawable and BadWindow errors.

The XGetGeometry function returns the root window and the current geometry of the drawable. The geometry of the drawable includes the x and y coordinates, width and height, border width, and depth. These are described in the argument list. It is legal to pass to this function a window whose class is InputOnly.

Diagnostics

BadDrawable
A value for a Drawable argument does not name a defined Window or Pixmap.

BadWindow
A value for a Window argument does not name a defined Window.

Museum