Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-5.0)
Apropos / Subsearch:
optional field

XDestroyWindow(3)               XLIB FUNCTIONS               XDestroyWindow(3)

       XDestroyWindow, XDestroySubwindows - destroy windows

       int XDestroyWindow(Display *display, Window w);

       int XDestroySubwindows(Display *display, Window w);

       display   Specifies the connection to the X server.

       w         Specifies the window.

       The XDestroyWindow function destroys the specified window as well as
       all of its subwindows and causes the X server to generate a DestroyNo-
       tify event for each window.  The window should never be referenced
       again.  If the window specified by the w argument is mapped, it is
       unmapped automatically.  The ordering of the DestroyNotify events is
       such that for any given window being destroyed, DestroyNotify is gener-
       ated on any inferiors of the window before being generated on the win-
       dow itself.  The ordering among siblings and across subhierarchies is
       not otherwise constrained.  If the window you specified is a root win-
       dow, no windows are destroyed.  Destroying a mapped window will gener-
       ate Expose events on other windows that were obscured by the window
       being destroyed.

       XDestroyWindow can generate a BadWindow error.

       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

       XDestroySubwindows can generate a BadWindow error.

       BadWindow A value for a Window argument does not name a defined Window.

       XChangeWindowAttributes(3X11), XConfigureWindow(3X11), XCreateWin-
       dow(3X11), XMapWindow(3X11), XRaiseWindow(3X11), XUnmapWindow(3X11)
       Xlib - C Language X Interface

X Version 11                     libX11 1.1.5                XDestroyWindow(3)