Manual pages › X Window and screen libraries (3X)

XGetWAttr(3X)

get current window attribute or geometry

From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.

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 XWIN 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

XWIN 3.0               Last change: 9/1/88                 .ie t

     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 attri-
butes 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 draw-
able includes the x and y coordinates, width and height,
border width, and depth.  These are described in the argu-
ment 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