XDestroySubwindows()XDestroySubwindows()NameXDestroySubwindows – destroy all subwindows of a window.
Synopsis
XDestroySubwindows(display, w)
Display *display;
Window w;
Arguments
display Specifies a connection to an X server; returned from
XOpenDisplay().
w Specifies the ID of the window whose subwindows are to be
destroyed.
Description
This function destroys all descendants of the specified window (recur‐
sively), in bottom to top stacking order.
XDestroySubwindows() generates exposure events on window w, if any
mapped subwindows were actually destroyed. This is much more efficient
than deleting many subwindows one at a time, since much of the work
need only be performed once for all of the windows rather than for each
window. It also saves multiple exposure events on the windows about to
be destroyed. The subwindows should never again be referenced. The X
server generates a DestroyNotify event for each window destroyed.
XCloseDisplay() automatically destroys all windows that have been cre‐
ated by that client on the specified display (unless called after a
fork system call).
Never call XDestroySubwindows() with the window argument set to the
root window! This will destroy all the applications on the screen, and
if there is only one screen, often the server as well.
Errors
BadWindow
See AlsoXCreateSimpleWindow(), XCreateWindow(), XDestroyWindow().
Xlib - Window Existence XDestroySubwindows()
