NAME
XUnmapWindow, XUnmapSubwindows - unmap windows
SYNTAX
int XUnmapWindow(Display *_d_i_s_p_l_a_y, Window _w);
int XUnmapSubwindows(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_U_n_m_a_p_W_i_n_d_o_w
function unmaps the specified window and causes the X server to generate an
_U_n_m_a_p_N_o_t_i_f_y
event.
If the specified window is already unmapped,
_X_U_n_m_a_p_W_i_n_d_o_w
has no effect.
Normal exposure processing on formerly obscured windows is performed.
Any child window will no longer be visible until another map call is
made on the parent.
In other words, the subwindows are still mapped but are not visible
until the parent is mapped.
Unmapping a window will generate
_E_x_p_o_s_e
events on windows that were formerly obscured by it.
_X_U_n_m_a_p_W_i_n_d_o_w
can generate a
_B_a_d_W_i_n_d_o_w
error.
The
_X_U_n_m_a_p_S_u_b_w_i_n_d_o_w_s
function unmaps all subwindows for the specified window in bottom-to-top
stacking order.
It causes the X server to generate an
_U_n_m_a_p_N_o_t_i_f_y
event on each subwindow and
_E_x_p_o_s_e
events on formerly obscured windows.
Using this function is much more efficient than unmapping multiple 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_U_n_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),
XMapWindow(3X11)
XRaiseWindow(3X11)
_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e