hpux man page for xdestroysubwindows

XDestroySubwindows()													      XDestroySubwindows()

Name
  XDestroySubwindows - 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 (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().

Xlib - Window Existence 												      XDestroySubwindows()