XUnmapWindow(3X)                                 XUnmapWindow(3X)



NAME
     XUnmapWindow, XUnmapSubwindows - unmap windows

SYNOPSIS
     XUnmapWindow (display, w)
     Display *display;
     Window w;

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

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 processing on formerly obscured
     windows is performed.  Any child window is no longer visible
     until another map call is made on the parent.  In other
     words, the subwindows are still mapped but are not visible
     until the parent is mapped.  Unmapping a window generates
     Expose events on windows that were formerly obscured by it.

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

   Arguments
     These functions accept the following arguments:

     display Specifies the connection to the X server.

     w       Specifies the window ID.

ERRORS
     BadWindow
             A value for a Window argument does not name a de-
             fined window.

     The XUnmapWindow and XUnmapSubwindows functions can generate
     a BadWindow error.

SEE ALSO
     XChangeWindowAttributes(3X), XConfigureWindow(3X),
     XCreateWindow(3X), XDestroyWindow(3X), XMapWindow(3X),
     XRaiseWindow(3X)

     Xlib - C Language Interface



November, 1990                                                  1