


XClearArea(3X11)					     XClearArea(3X11)
X11R5									X11R5



NAME
  XClearArea, XClearWindow - clear area	or window

SYNTAX
  XClearArea(_d_i_s_p_l_a_y, _w, _x, _y, _w_i_d_t_h, _h_e_i_g_h_t, _e_x_p_o_s_u_r_e_s)
	Display	*_d_i_s_p_l_a_y;
	Window _w;
	int _x, _y;
	unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
	Bool _e_x_p_o_s_u_r_e_s;

  XClearWindow(_d_i_s_p_l_a_y,	_w)
	Display	*_d_i_s_p_l_a_y;
	Window _w;

ARGUMENTS

  _d_i_s_p_l_a_y   Specifies the connection to	the X server.

  _e_x_p_o_s_u_r_e_s Specifies a	Boolean	value that indicates if	_E_x_p_o_s_e events are to
	    be generated.

  _w	    Specifies the window.

  _w_i_d_t_h
  _h_e_i_g_h_t    Specify the	width and height, which	are the	dimensions of the
	    rectangle.

  _x
  _y	    Specify the	x and y	coordinates, which are relative	to the origin
	    of the window and specify the upper-left corner of the rectangle.

DESCRIPTION
  The _X_C_l_e_a_r_A_r_e_a function paints a rectangular area in the specified window
  according to the specified dimensions	with the window's background pixel or
  pixmap.  The subwindow-mode effectively is _C_l_i_p_B_y_C_h_i_l_d_r_e_n.  If width is
  zero,	it is replaced with the	current	width of the window minus x.  If
  height is zero, it is	replaced with the current height of the	window minus
  y.  If the window has	a defined background tile, the rectangle clipped by
  any children is filled with this tile.  If the window	has background _N_o_n_e,
  the contents of the window are not changed. In either	case, if exposures is
  _T_r_u_e,	one or more _E_x_p_o_s_e events are generated	for regions of the rectangle
  that are either visible or are being retained	in a backing store.  If	you
  specify a window whose class is _I_n_p_u_t_O_n_l_y, a _B_a_d_M_a_t_c_h	error results.

  _X_C_l_e_a_r_A_r_e_a can generate _B_a_d_M_a_t_c_h, _B_a_d_V_a_l_u_e, and _B_a_d_W_i_n_d_o_w errors.

  The _X_C_l_e_a_r_W_i_n_d_o_w function clears the entire area in the specified window
  and is equivalent to _X_C_l_e_a_r_A_r_e_a (display, w, 0, 0, 0,	0, _F_a_l_s_e).  If the
  window has a defined background tile,	the rectangle is tiled with a plane-
  mask of all ones and _G_X_c_o_p_y function.	 If the	window has background _N_o_n_e,
  the contents of the window are not changed. If you specify a window whose
  class	is _I_n_p_u_t_O_n_l_y, a	_B_a_d_M_a_t_c_h error results.

  _X_C_l_e_a_r_W_i_n_d_o_w can generate _B_a_d_M_a_t_c_h and _B_a_d_W_i_n_d_o_w errors.



DIAGNOSTICS

  _B_a_d_M_a_t_c_h  An _I_n_p_u_t_O_n_l_y window	is used	as a Drawable.

  _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of values accepted by
	    the	request.  Unless a specific range is specified for an argu-
	    ment, the full range defined by the	argument's type	is accepted.
	    Any	argument defined as a set of alternatives can generate this
	    error.

  _B_a_d_W_i_n_d_o_w A value for	a Window argument does not name	a defined Window.

SEE ALSO
  XCopyArea(3X11)
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e	delim off



















































