XUnmapWindow
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)