A window remains visible on its frame unless you delete it by calling certain functions that delete windows. A deleted window cannot appear on the screen, but continues to exist as a Lisp object until there are no references to it. There is no way to cancel the deletion of a window aside from restoring a saved window configuration (see Window Configurations). Restoring a window configuration also deletes any windows that aren't part of that configuration.
When you delete a window, the space it took up is given to one of its sibling windows adjacent to it.
This function returns
nilif window is deleted, and
Warning: Erroneous information or fatal errors may result from using a deleted window as if it were live.
This function removes window from display and returns
nil. The default for window is the selected window. An error is signaled if window is the only window on its frame.
This function makes window the only window on its frame, by deleting the other windows in that frame. The default for window is the selected window. The return value is
This function deletes all windows showing buffer-or-name. If there are no windows showing buffer-or-name, it does nothing. The optional argument buffer-or-name may be a buffer or the name of an existing buffer and defaults to the current buffer.
delete-windows-onoperates frame by frame. If a frame has several windows showing different buffers, then those showing buffer-or-name are removed, and the others expand to fill the space. If all windows in some frame are showing buffer-or-name (including the case where there is only one window), then the frame winds up with a single window showing another buffer chosen with
other-buffer(see The Buffer List). If, however, the window showing buffer-or-name is dedicated to its buffer (see Dedicated Windows), and there are other frames left, that window's frame is deleted.
The optional argument frame specifies which frames to operate on. This function does not use it in quite the same way as the other functions which scan all windows; specifically, the values
nilhave the opposite of their meanings in other functions. Here are the full details:
- If it is
nil, operate on all frames.
- If it is
t, operate on the selected frame.
- If it is
visible, operate on all visible frames.
- If it is 0, operate on all visible or iconified frames.
- If it is a frame, operate on that frame.
This function always returns