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()
