


XMapWindow(3X11)					     XMapWindow(3X11)
X11R5									X11R5



NAME
  XMapWindow, XMapRaised, XMapSubwindows - map windows

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

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

  XMapSubwindows(_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.

  _w	    Specifies the window.

DESCRIPTION
  The _X_M_a_p_W_i_n_d_o_w function maps the window and all of its subwindows that have
  had map requests.  Mapping a window that has an unmapped ancestor does not
  display the window but marks it as eligible for display when the ancestor
  becomes mapped.  Such	a window is called unviewable.	When all its ances-
  tors are mapped, the window becomes viewable and will	be visible on the
  screen if it is not obscured by another window.  This	function has no
  effect if the	window is already mapped.

  If the override-redirect of the window is _F_a_l_s_e and if some other client
  has selected _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k	on the parent window, then the X
  server generates a _M_a_p_R_e_q_u_e_s_t	event, and the _X_M_a_p_W_i_n_d_o_w function does	not
  map the window.  Otherwise, the window is mapped, and	the X server gen-
  erates a _M_a_p_N_o_t_i_f_y event.

  If the window	becomes	viewable and no	earlier	contents for it	are remem-
  bered, the X server tiles the	window with its	background.  If	the window's
  background is	undefined, the existing	screen contents	are not	altered, and
  the X	server generates zero or more _E_x_p_o_s_e events.  If backing-store was
  maintained while the window was unmapped, no _E_x_p_o_s_e events are generated.
  If backing-store will	now be maintained, a full-window exposure is always
  generated.  Otherwise, only visible regions may be reported.	Similar	til-
  ing and exposure take	place for any newly viewable inferiors.

  If the window	is an _I_n_p_u_t_O_u_t_p_u_t window, _X_M_a_p_W_i_n_d_o_w generates _E_x_p_o_s_e events
  on each _I_n_p_u_t_O_u_t_p_u_t window that it causes to be displayed.  If the client
  maps and paints the window and if the	client begins processing events, the
  window is painted twice.  To avoid this, first ask for _E_x_p_o_s_e	events and
  then map the window, so the client processes input events as usual.  The
  event	list will include _E_x_p_o_s_e for each window that has appeared on the
  screen. The client's normal response to an _E_x_p_o_s_e event should be to
  repaint the window.  This method usually leads to simpler programs and to
  proper interaction with window managers.

  _X_M_a_p_W_i_n_d_o_w can generate a _B_a_d_W_i_n_d_o_w error.

  The _X_M_a_p_R_a_i_s_e_d function essentially is similar to _X_M_a_p_W_i_n_d_o_w in that it
  maps the window and all of its subwindows that have had map requests.	 How-
  ever,	it also	raises the specified window to the top of the stack.

  _X_M_a_p_R_a_i_s_e_d can generate a _B_a_d_W_i_n_d_o_w error.

  The _X_M_a_p_S_u_b_w_i_n_d_o_w_s function maps all subwindows for a	specified window in
  top-to-bottom	stacking order.	 The X server generates	_E_x_p_o_s_e events on each
  newly	displayed window.  This	may be much more efficient than	mapping	many
  windows one at a time	because	the server needs to perform much of the	work
  only once, for all of	the windows, rather than for each window.

  _X_M_a_p_S_u_b_w_i_n_d_o_w_s can generate a	_B_a_d_W_i_n_d_o_w error.

DIAGNOSTICS

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

SEE ALSO
  XChangeWindowAttributes(3X11), XConfigureWindow(3X11), XCreateWindow(3X11),
  XDestroyWindow(3X11),	XRaiseWindow(3X11), XUnmapWindow(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












































