NAME
XDestroySubwindows − destroy all subwindows of a window.
Synopsis
XDestroySubwindows(display, w)
Display *display;
Window w;
Arguments
displaySpecifies a connection to an X server; returned from XOpenDisplay().
wSpecifies the ID of the window whose subwindows are to be destroyed.
Description
This function destroys all descendants of the specified window (recursively), 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 created 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 Also
XCreateSimpleWindow(), XCreateWindow(), XDestroyWindow().
Copyright O’Reilly & Assoc. —