NAME

XDestroyWindow − unmap and destroy a window and all subwindows. 

Synopsis

XDestroyWindow(display, w)
Display *display;
Window w;

Arguments

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

wSpecifies the ID of the window to be destroyed. 

Description

If w is mapped, an UnmapWindow request is performed automatically.  The window and all inferiors (recursively) are then destroyed, and a DestroyNotify event is generated for each window.  The ordering of the DestroyNotify events is such that for any given window, DestroyNotify is generated on all inferiors of the window before being generated on the window itself.  The ordering among siblings and across subhierarchies is not otherwise constrained.  The windows should never again be referenced.  Destroying a mapped window will generate exposure events on other windows that were obscured by the windows being destroyed.  XDestroyWindow() may also generate EnterNotify events if w was mapped and contained the pointer.  No windows are destroyed if you try to destroy the root window. 

Errors

BadWindow

See Also

XCreateSimpleWindow(), XCreateWindow(), XDestroySubwindows(). 

Copyright O’Reilly & Assoc.  —