Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
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 un-
       mapped automatically.  The ordering of the DestroyNotify	events is such
       that for	any given window being destroyed, DestroyNotify	is generated
       on any inferiors	of the window before being generated on	the window it-
       self.  The ordering among siblings and across subhierarchies is not
       otherwise constrained.  If the window you specified is a	root window,
       no windows are destroyed.  Destroying a mapped window will generate Ex-
       pose events on other windows that were obscured by the window being de-

       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(3), XConfigureWindow(3),	XCreateWindow(3),
       XMapWindow(3), XRaiseWindow(3), XUnmapWindow(3)
       Xlib - C	Language X Interface

X Version 11			 libX11	1.6.5		     XDestroyWindow(3)


Want to link to this manual page? Use this URL:

home | help