XClearArea(XS)

Syntax

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

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

Arguments

display

Specifies the connection to the X server.

exposures

Specifies a Boolean value that indicates if Expose events are to be generated.

w

Specifies the window.

width
height

Specify the width and height, which are the dimensions of the rectangle. and specify the upper-left corner of the rectangle

x
y

Specify the x and y coordinates, which are relative to the origin of the window.

Description

XClearArea can generate ``BadMatch'', ``BadValue'', and ``BadWindow'' errors.

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.

``BadValue''

Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined by the argument's type is accepted. Any argument defined as a set of alternatives can generate this error.

``BadWindow''

A value for a Window argument does not name a defined Window.

See also