X Version 11 (1 September 1988) XGetWindowAttributes(XS)
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.
d Specifies the drawable, which can be a window or a
pixmap.
depth_return
Returns the depth of the drawable (bits per pixel
for the object).
display Specifies the connection to the X server.
root_return
Returns the root window.
w Specifies 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_return Return 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.
SEE ALSO
XQueryPointer(XS), XQueryTree(XS)
Xlib - C Language X Interface
(printed 2/12/90) (1 September 1988)XGetWindowAttributes(XS)