XClearWindow

Syntax

XClearWindow(display, w)
      Display *display;
      Window w;

Arguments

display Specifies the connection to the X server.
w Specifies the window.

Description

The XClearWindow() function clears the entire area in the specified window and is equivalent to XClearArea(display, w, 0, 0, 0, 0, False). If the window has a defined background tile, the rectangle is tiled with a plane-mask of all ones and GXcopy function. If the window has background None, the contents of the window are not changed. If you specify a window whose class is InputOnly , a BadMatch error results.

XClearWindow() can generate BadMatch and BadWindow errors.

Diagnostics

BadMatch An InputOnly window is used as a Drawable.
BadMatch Some argument or pair of arguments has the correct type and range but fails to match in some other way required by the request.
BadWindow A value for a Window argument does not name a defined Window.

See also

XClearArea(), XCopyArea(), "Clearing Areas".
Christophe Tronche, ch@tronche.com