XUnmapWindow

TriggerTek Logo
abcdefghijklmnopqrstuvwxyz_
XUnmapWindow(3X11)		XLIB FUNCTIONS		   XUnmapWindow(3X11)



NAME
       XUnmapWindow, XUnmapSubwindows - unmap windows

SYNTAX
       int XUnmapWindow(Display *display, Window w);

       int XUnmapSubwindows(Display *display, Window w);

ARGUMENTS
       display	 Specifies the connection to the X server.

       w	 Specifies the window.

DESCRIPTION
       The XUnmapWindow function unmaps the specified window and causes the X
       server to generate an UnmapNotify event.	 If the specified window is
       already unmapped, XUnmapWindow has no effect.  Normal exposure pro-
       cessing on formerly obscured windows is performed.  Any child window
       will no longer be visible until another map call is made on the par-
       ent.  In other words, the subwindows are still mapped but are not vis-
       ible until the parent is mapped.	 Unmapping a window will generate
       Expose events on windows that were formerly obscured by it.

       XUnmapWindow can generate a BadWindow error.

       The XUnmapSubwindows function unmaps all subwindows for the specified
       window in bottom-to-top stacking order.	It causes the X server to
       generate an UnmapNotify event on each subwindow and Expose events on
       formerly obscured windows.  Using this function is much more efficient
       than unmapping multiple windows one at a time because the server needs
       to perform much of the work only once, for all of the windows, rather
       than for each window.

       XUnmapSubwindows can generate a BadWindow error.

DIAGNOSTICS
       BadWindow A value for a Window argument does not name a defined Win-
		 dow.

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



							   XUnmapWindow(3X11)