XClearArea()XClearArea()NameXClearArea – 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 XOpenDis‐
play().
w Specifies the ID of an InputOutput window.
x Specify the x and y coordinates of the upper-left corner of
y the rectangle to be cleared, relative to the origin of the
window.
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.
DescriptionXClearArea() 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 gener‐
ated 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 AlsoXClearWindow(), XCopyArea(), XCopyPlane(), XDraw, XDrawArc(),
XDrawArcs(), XDrawFilled(), XDrawLine(), XDrawLines(), XDrawPoint(),
XDrawPoints(), XDrawRectangle(), XDrawRectangles(), XDrawSegments(),
XFillArc(), XFillArcs(), XFillPolygon(), XFillRectangle(), XFillRectan‐
gles().
Xlib - Drawing Primitives XClearArea()
