XClearArea()															      XClearArea()

Name
  XClearArea - clear a rectangular area in a window.

Synopsis
  XClearArea(display, w, x, y, width, height, exposures)
	Display *display;
	Window w;
	int x, y;
	unsigned int width, height;
	Bool exposures;

Arguments
  display  Specifies a connection to an X server; returned from XOpenDisplay().

  w	   Specifies the ID of an InputOutput window.

  x	   Specify the x and y coordinates of the upper-left corner of the rectangle to be cleared, relative to the origin of the window.
  y
  width    Specify the dimensions in pixels of the rectangle to be cleared.
  height

  exposures
	   Specifies whether exposure events are generated.  Must be either True or False.

Description
  XClearArea() clears a rectangular area in a window.

  If  width  is  zero,	the window is cleared from x to the right edge of the window.  If height is zero, the window is cleared from y to the
  bottom of the window.  See the figure on the next page..

  If the window has a defined background tile or it is ParentRelative, the rectangle is tiled with a plane_mask of all	1's,  a  function  of
  GXcopy,  and a subwindow_mode of ClipByChildren.  If the window has background None, the contents of the window are not changed.  In either
  case, if exposures is True, then one or more exposure events are generated for regions of the rectangle that	are  either  visible  or  are
  being retained in a backing store.

  For more information, see Volume One, Chapter 6, Drawing Graphics and Text.

Errors
  BadMatch  Window is an InputOnly class window.

  BadValue

  BadWindow

See Also
  XClearWindow(),  XCopyArea(),  XCopyPlane(), XDraw, XDrawArc(), XDrawArcs(), XDrawFilled(), XDrawLine(), XDrawLines(), XDrawPoint(), XDraw-
  Points(), XDrawRectangle(), XDrawRectangles(), XDrawSegments(), XFillArc(),  XFillArcs(),  XFillPolygon(),  XFillRectangle(),  XFillRectan-
  gles().

Xlib - Drawing Primitives													      XClearArea()