


XIconifyWindow(3X11)					 XIconifyWindow(3X11)
X11R5									X11R5



NAME
  XIconifyWindow, XWithdrawWindow, XReconfigureWMWindow	- manipulate top-
  level	windows

SYNTAX
  Status XIconifyWindow(_d_i_s_p_l_a_y, _w, _s_c_r_e_e_n__n_u_m_b_e_r)
	Display	*_d_i_s_p_l_a_y;
	Window _w;
	int _s_c_r_e_e_n__n_u_m_b_e_r;

  Status XWithdrawWindow(_d_i_s_p_l_a_y, _w, _s_c_r_e_e_n__n_u_m_b_e_r)
	Display	*_d_i_s_p_l_a_y;
	Window _w;
	int _s_c_r_e_e_n__n_u_m_b_e_r;

  Status XReconfigureWMWindow(_d_i_s_p_l_a_y, _w, _s_c_r_e_e_n__n_u_m_b_e_r, _v_a_l_u_e__m_a_s_k, _v_a_l_u_e_s)
	Display	*_d_i_s_p_l_a_y;
	Window _w;
	int _s_c_r_e_e_n__n_u_m_b_e_r;
	unsigned int _v_a_l_u_e__m_a_s_k;
	XWindowChanges *_v_a_l_u_e_s;

ARGUMENTS

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

  _s_c_r_e_e_n__n_u_m_b_e_r
	    Specifies the appropriate screen number on the host	server.

  _v_a_l_u_e__m_a_s_k
	    Specifies which values are to be set using information in the
	    values structure.  This mask is the	bitwise	inclusive OR of	the
	    valid configure window values bits.

  _v_a_l_u_e_s    Specifies the _X_W_i_n_d_o_w_C_h_a_n_g_e_s structure.

  _w	    Specifies the window.

DESCRIPTION
  The _X_I_c_o_n_i_f_y_W_i_n_d_o_w function sends a WM_CHANGE_STATE _C_l_i_e_n_t_M_e_s_s_a_g_e event
  with a format	of 32 and a first data element of _I_c_o_n_i_c_S_t_a_t_e (as described
  in section 4.1.4 of the _I_n_t_e_r-_C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l) and
  a window of w	to the root window of the specified screen with	an event mask
  set to _S_u_b_s_t_r_u_c_t_u_r_e_N_o_t_i_f_y_M_a_s_k| _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k.  Window managers
  may elect to receive this message and	if the window is in its	normal state,
  may treat it as a request to change the window's state from normal to
  iconic.  If the WM_CHANGE_STATE property cannot be interned, _X_I_c_o_n_i_f_y_W_i_n_d_o_w
  does not send	a message and returns a	zero status.  It returns a nonzero
  status if the	client message is sent successfully; otherwise,	it returns a
  zero status.


  The _X_W_i_t_h_d_r_a_w_W_i_n_d_o_w function unmaps the specified window and sends a syn-
  thetic _U_n_m_a_p_N_o_t_i_f_y event to the root window of the specified screen.	Win-
  dow managers may elect to receive this message and may treat it as a
  request to change the	window's state to withdrawn.  When a window is in the
  withdrawn state, neither its normal nor its iconic representations is	visi-
  ble.	It returns a nonzero status if the _U_n_m_a_p_N_o_t_i_f_y event is	successfully
  sent;	otherwise, it returns a	zero status.

  _X_W_i_t_h_d_r_a_w_W_i_n_d_o_w can generate a _B_a_d_W_i_n_d_o_w error.

  The _X_R_e_c_o_n_f_i_g_u_r_e_W_M_W_i_n_d_o_w function issues a _C_o_n_f_i_g_u_r_e_W_i_n_d_o_w request on	the
  specified top-level window.  If the stacking mode is changed and the
  request fails	with a _B_a_d_M_a_t_c_h	error, the error is trapped by Xlib and	a
  synthetic _C_o_n_f_i_g_u_r_e_R_e_q_u_e_s_t_E_v_e_n_t containing the same configuration parame-
  ters is sent to the root of the specified window.  Window managers may
  elect	to receive this	event and treat	it as a	request	to reconfigure the
  indicated window.  It	returns	a nonzero status if the	request	or event is
  successfully sent; otherwise,	it returns a zero status.

  _X_R_e_c_o_n_f_i_g_u_r_e_W_M_W_i_n_d_o_w can generate _B_a_d_V_a_l_u_e and _B_a_d_W_i_n_d_o_w errors.

DIAGNOSTICS

  _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
  XChangeWindowAttributes(3X11), XConfigureWindow(3X11), XCreateWindow(3X11),
  XDestroyWindow(3X11),	XRaiseWindow(3X11), XMapWindow(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




































