NAME

XIconifyWindow, XWithdrawWindow, XReconfigureWMWindow - manipulate top-level windows

SYNTAX

Status XIconifyWindow(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(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(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 synthetic _U_n_m_a_p_N_o_t_i_f_y event to the root window of the specified screen. Window 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 visible. 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 parameters 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 argument, 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