XDestroySubwindows
Syntax
XDestroySubwindows(display, w)
Display *display;
Window w;
Arguments
| display
| Specifies the connection to the X server.
|
| w
| Specifies the window.
|
Description
The
XDestroySubwindows()
function destroys all inferior windows of the specified window,
in bottom-to-top stacking order.
It causes the X server to generate a
DestroyNotify
event for each window.
If any mapped
subwindows were actually destroyed,
XDestroySubwindows()
causes the X server to generate
Expose
events on the specified window.
This is much more efficient than deleting many windows
one at a time because much of the work need be performed only once for all
of the windows, rather than for each window.
The subwindows should never be referenced again.
XDestroySubwindows()
can generate a
BadWindow
error.
Diagnostics
| BadWindow
| A value for a Window argument does not name a defined Window.
|
See also
XChangeWindowAttributes(),
XConfigureWindow(),
XCreateWindow(),
XDestroyWindow(),
XMapWindow(),
XRaiseWindow(),
XUnmapWindow(),
"Destroying Windows"
Christophe Tronche, ch@tronche.com