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