Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

XQueryPointer(3X11)

XQueryTree(3X11)

XGetWindowAttributes(3X11)           SysV           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.

     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(3X11), XQueryTree(3X11)
     Xlib - C Language X Interface

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026