mirror of
https://git.savannah.gnu.org/git/emacs.git
synced 2024-12-16 09:50:25 +00:00
354 lines
14 KiB
EmacsLisp
354 lines
14 KiB
EmacsLisp
;;; window.el --- GNU Emacs window commands aside from those written in C.
|
||
|
||
;; Copyright (C) 1985, 1989, 1992, 1993, 1994 Free Software Foundation, Inc.
|
||
|
||
;; Maintainer: FSF
|
||
|
||
;; This file is part of GNU Emacs.
|
||
|
||
;; GNU Emacs is free software; you can redistribute it and/or modify
|
||
;; it under the terms of the GNU General Public License as published by
|
||
;; the Free Software Foundation; either version 2, or (at your option)
|
||
;; any later version.
|
||
|
||
;; GNU Emacs is distributed in the hope that it will be useful,
|
||
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
;; GNU General Public License for more details.
|
||
|
||
;; You should have received a copy of the GNU General Public License
|
||
;; along with GNU Emacs; see the file COPYING. If not, write to the
|
||
;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
||
;; Boston, MA 02111-1307, USA.
|
||
|
||
;;; Code:
|
||
|
||
;;;; Window tree functions.
|
||
|
||
(defun one-window-p (&optional nomini all-frames)
|
||
"Returns non-nil if the selected window is the only window (in its frame).
|
||
Optional arg NOMINI non-nil means don't count the minibuffer
|
||
even if it is active.
|
||
|
||
The optional arg ALL-FRAMES t means count windows on all frames.
|
||
If it is `visible', count windows on all visible frames.
|
||
ALL-FRAMES nil or omitted means count only the selected frame,
|
||
plus the minibuffer it uses (which may be on another frame).
|
||
If ALL-FRAMES is neither nil nor t, count only the selected frame."
|
||
(let ((base-window (selected-window)))
|
||
(if (and nomini (eq base-window (minibuffer-window)))
|
||
(setq base-window (next-window base-window)))
|
||
(eq base-window
|
||
(next-window base-window (if nomini 'arg) all-frames))))
|
||
|
||
(defun walk-windows (proc &optional minibuf all-frames)
|
||
"Cycle through all visible windows, calling PROC for each one.
|
||
PROC is called with a window as argument.
|
||
|
||
Optional second arg MINIBUF t means count the minibuffer window even
|
||
if not active. MINIBUF nil or omitted means count the minibuffer iff
|
||
it is active. MINIBUF neither t nor nil means not to count the
|
||
minibuffer even if it is active.
|
||
|
||
Several frames may share a single minibuffer; if the minibuffer
|
||
counts, all windows on all frames that share that minibuffer count
|
||
too. Therefore, if you are using a separate minibuffer frame
|
||
and the minibuffer is active and MINIBUF says it counts,
|
||
`walk-windows' includes the windows in the frame from which you
|
||
entered the minibuffer, as well as the minibuffer window.
|
||
|
||
ALL-FRAMES is the optional third argument.
|
||
ALL-FRAMES nil or omitted means cycle within the frames as specified above.
|
||
ALL-FRAMES = `visible' means include windows on all visible frames.
|
||
ALL-FRAMES = 0 means include windows on all visible and iconified frames.
|
||
ALL-FRAMES = t means include windows on all frames including invisible frames.
|
||
Anything else means restrict to the selected frame."
|
||
;; If we start from the minibuffer window, don't fail to come back to it.
|
||
(if (window-minibuffer-p (selected-window))
|
||
(setq minibuf t))
|
||
(let* ((walk-windows-start (selected-window))
|
||
(walk-windows-current walk-windows-start))
|
||
(while (progn
|
||
(setq walk-windows-current
|
||
(next-window walk-windows-current minibuf all-frames))
|
||
(funcall proc walk-windows-current)
|
||
(not (eq walk-windows-current walk-windows-start))))))
|
||
|
||
(defun minibuffer-window-active-p (window)
|
||
"Return t if WINDOW (a minibuffer window) is now active."
|
||
(eq window (active-minibuffer-window)))
|
||
|
||
(defmacro save-selected-window (&rest body)
|
||
"Execute BODY, then select the window that was selected before BODY."
|
||
(list 'let
|
||
'((save-selected-window-window (selected-window)))
|
||
(list 'unwind-protect
|
||
(cons 'progn body)
|
||
(list 'select-window 'save-selected-window-window))))
|
||
|
||
(defun count-windows (&optional minibuf)
|
||
"Returns the number of visible windows.
|
||
This counts the windows in the selected frame and (if the minibuffer is
|
||
to be counted) its minibuffer frame (if that's not the same frame).
|
||
The optional arg MINIBUF non-nil means count the minibuffer
|
||
even if it is inactive."
|
||
(let ((count 0))
|
||
(walk-windows (function (lambda (w)
|
||
(setq count (+ count 1))))
|
||
minibuf)
|
||
count))
|
||
|
||
(defun balance-windows ()
|
||
"Makes all visible windows the same height (approximately)."
|
||
(interactive)
|
||
(let ((count -1) levels newsizes size
|
||
;; Don't count the lines that are above the uppermost windows.
|
||
;; (These are the menu bar lines, if any.)
|
||
(mbl (nth 1 (window-edges (frame-first-window (selected-frame))))))
|
||
;; Find all the different vpos's at which windows start,
|
||
;; then count them. But ignore levels that differ by only 1.
|
||
(save-window-excursion
|
||
(let (tops (prev-top -2))
|
||
(walk-windows (function (lambda (w)
|
||
(setq tops (cons (nth 1 (window-edges w))
|
||
tops))))
|
||
'nomini)
|
||
(setq tops (sort tops '<))
|
||
(while tops
|
||
(if (> (car tops) (1+ prev-top))
|
||
(setq prev-top (car tops)
|
||
count (1+ count)))
|
||
(setq levels (cons (cons (car tops) count) levels))
|
||
(setq tops (cdr tops)))
|
||
(setq count (1+ count))))
|
||
;; Subdivide the frame into that many vertical levels.
|
||
(setq size (/ (- (frame-height) mbl) count))
|
||
(walk-windows (function
|
||
(lambda (w)
|
||
(select-window w)
|
||
(let ((newtop (cdr (assq (nth 1 (window-edges))
|
||
levels)))
|
||
(newbot (or (cdr (assq (+ (window-height)
|
||
(nth 1 (window-edges)))
|
||
levels))
|
||
count)))
|
||
(setq newsizes
|
||
(cons (cons w (* size (- newbot newtop)))
|
||
newsizes)))))
|
||
'nomini)
|
||
(walk-windows (function (lambda (w)
|
||
(select-window w)
|
||
(let ((newsize (cdr (assq w newsizes))))
|
||
(enlarge-window (- newsize
|
||
(window-height))))))
|
||
'nomini)))
|
||
|
||
;;; I think this should be the default; I think people will prefer it--rms.
|
||
(defcustom split-window-keep-point t
|
||
"*If non-nil, split windows keeps the original point in both children.
|
||
This is often more convenient for editing.
|
||
If nil, adjust point in each of the two windows to minimize redisplay.
|
||
This is convenient on slow terminals, but point can move strangely."
|
||
:type 'boolean
|
||
:group 'windows)
|
||
|
||
(defun split-window-vertically (&optional arg)
|
||
"Split current window into two windows, one above the other.
|
||
The uppermost window gets ARG lines and the other gets the rest.
|
||
Negative arg means select the size of the lowermost window instead.
|
||
With no argument, split equally or close to it.
|
||
Both windows display the same buffer now current.
|
||
|
||
If the variable `split-window-keep-point' is non-nil, both new windows
|
||
will get the same value of point as the current window. This is often
|
||
more convenient for editing.
|
||
|
||
Otherwise, we chose window starts so as to minimize the amount of
|
||
redisplay; this is convenient on slow terminals. The new selected
|
||
window is the one that the current value of point appears in. The
|
||
value of point can change if the text around point is hidden by the
|
||
new mode line."
|
||
(interactive "P")
|
||
(let ((old-w (selected-window))
|
||
(old-point (point))
|
||
(size (and arg (prefix-numeric-value arg)))
|
||
(window-full-p nil)
|
||
new-w bottom switch moved)
|
||
(and size (< size 0) (setq size (+ (window-height) size)))
|
||
(setq new-w (split-window nil size))
|
||
(or split-window-keep-point
|
||
(progn
|
||
(save-excursion
|
||
(set-buffer (window-buffer))
|
||
(goto-char (window-start))
|
||
(setq moved (vertical-motion (window-height)))
|
||
(set-window-start new-w (point))
|
||
(if (> (point) (window-point new-w))
|
||
(set-window-point new-w (point)))
|
||
(and (= moved (window-height))
|
||
(progn
|
||
(setq window-full-p t)
|
||
(vertical-motion -1)))
|
||
(setq bottom (point)))
|
||
(and window-full-p
|
||
(<= bottom (point))
|
||
(set-window-point old-w (1- bottom)))
|
||
(and window-full-p
|
||
(<= (window-start new-w) old-point)
|
||
(progn
|
||
(set-window-point new-w old-point)
|
||
(select-window new-w)))))
|
||
(split-window-save-restore-data new-w old-w)))
|
||
|
||
;; This is to avoid compiler warnings.
|
||
(defvar view-return-to-alist)
|
||
|
||
(defun split-window-save-restore-data (new-w old-w)
|
||
(save-excursion
|
||
(set-buffer (window-buffer))
|
||
(if view-mode
|
||
(let ((old-info (assq old-w view-return-to-alist)))
|
||
(setq view-return-to-alist
|
||
(cons (cons new-w (cons (and old-info (car (cdr old-info))) t))
|
||
view-return-to-alist))))
|
||
new-w))
|
||
|
||
(defun split-window-horizontally (&optional arg)
|
||
"Split current window into two windows side by side.
|
||
This window becomes the leftmost of the two, and gets ARG columns.
|
||
Negative arg means select the size of the rightmost window instead.
|
||
The argument includes the width of the window's scroll bar; if there
|
||
are no scroll bars, it includes the width of the divider column
|
||
to the window's right, if any. No arg means split equally."
|
||
(interactive "P")
|
||
(let ((old-w (selected-window))
|
||
(size (and arg (prefix-numeric-value arg))))
|
||
(and size (< size 0)
|
||
(setq size (+ (window-width) size)))
|
||
(split-window-save-restore-data (split-window nil size t) old-w)))
|
||
|
||
(defun enlarge-window-horizontally (arg)
|
||
"Make current window ARG columns wider."
|
||
(interactive "p")
|
||
(enlarge-window arg t))
|
||
|
||
(defun shrink-window-horizontally (arg)
|
||
"Make current window ARG columns narrower."
|
||
(interactive "p")
|
||
(shrink-window arg t))
|
||
|
||
(defun window-buffer-height (window)
|
||
"Return the height (in screen lines) of the buffer that WINDOW is displaying."
|
||
(save-excursion
|
||
(set-buffer (window-buffer window))
|
||
(goto-char (point-min))
|
||
(let ((ignore-final-newline
|
||
;; If buffer ends with a newline, ignore it when counting height
|
||
;; unless point is after it.
|
||
(and (not (eobp)) (eq ?\n (char-after (1- (point-max)))))))
|
||
(+ 1 (nth 2 (compute-motion (point-min)
|
||
'(0 . 0)
|
||
(- (point-max) (if ignore-final-newline 1 0))
|
||
(cons 0 100000000)
|
||
(window-width window)
|
||
nil
|
||
window))))))
|
||
|
||
(defun shrink-window-if-larger-than-buffer (&optional window)
|
||
"Shrink the WINDOW to be as small as possible to display its contents.
|
||
Do not shrink to less than `window-min-height' lines.
|
||
Do nothing if the buffer contains more lines than the present window height,
|
||
or if some of the window's contents are scrolled out of view,
|
||
or if the window is not the full width of the frame,
|
||
or if the window is the only window of its frame."
|
||
(interactive)
|
||
(save-selected-window
|
||
(if window
|
||
(select-window window)
|
||
(setq window (selected-window)))
|
||
(let* ((params (frame-parameters))
|
||
(mini (cdr (assq 'minibuffer params)))
|
||
(edges (window-edges)))
|
||
(if (and (< 1 (count-windows))
|
||
(= (window-width) (frame-width))
|
||
(pos-visible-in-window-p (point-min) window)
|
||
(not (eq mini 'only))
|
||
(or (not mini)
|
||
(< (nth 3 edges) (nth 1 (window-edges mini)))
|
||
(> (nth 1 edges) (cdr (assq 'menu-bar-lines params)))))
|
||
(let ((text-height (window-buffer-height window))
|
||
(window-height (window-height)))
|
||
;; Don't try to redisplay with the cursor at the end
|
||
;; on its own line--that would force a scroll and spoil things.
|
||
(when (and (eobp) (bolp) (not (bobp)))
|
||
(forward-char -1))
|
||
(when (> window-height (1+ text-height))
|
||
(shrink-window
|
||
(- window-height (max (1+ text-height) window-min-height)))))))))
|
||
|
||
(defun kill-buffer-and-window ()
|
||
"Kill the current buffer and delete the selected window."
|
||
(interactive)
|
||
(if (yes-or-no-p (format "Kill buffer `%s'? " (buffer-name)))
|
||
(let ((buffer (current-buffer)))
|
||
(delete-window (selected-window))
|
||
(kill-buffer buffer))
|
||
(error "Aborted")))
|
||
|
||
(defun quit-window (&optional kill window)
|
||
"Quit the current buffer. Bury it, and maybe delete the selected frame.
|
||
\(The frame is deleted if it is contains a dedicated window for the buffer.)
|
||
With a prefix argument, kill the buffer instead.
|
||
|
||
Noninteractively, if KILL is non-nil, then kill the current buffer,
|
||
otherwise bury it.
|
||
|
||
If WINDOW is non-nil, it specifies a window; we delete that window,
|
||
and the buffer that is killed or buried is the one in that window."
|
||
(interactive "P")
|
||
(let ((buffer (window-buffer window))
|
||
(frame (window-frame (or window (selected-window))))
|
||
(window-solitary
|
||
(save-selected-window
|
||
(if window
|
||
(select-window window))
|
||
(one-window-p t)))
|
||
window-handled)
|
||
|
||
(save-selected-window
|
||
(if window
|
||
(select-window window))
|
||
(or (window-minibuffer-p)
|
||
(window-dedicated-p (selected-window))
|
||
(switch-to-buffer (other-buffer))))
|
||
|
||
;; Get rid of the frame, if it has just one dedicated window
|
||
;; and other visible frames exist.
|
||
(and (or (window-minibuffer-p) (window-dedicated-p window))
|
||
(delq frame (visible-frame-list))
|
||
window-solitary
|
||
(if (and (eq default-minibuffer-frame frame)
|
||
(= 1 (length (minibuffer-frame-list))))
|
||
(setq window nil)
|
||
(delete-frame frame)
|
||
(setq window-handled t)))
|
||
|
||
;; Deal with the buffer.
|
||
(if kill
|
||
(kill-buffer buffer)
|
||
(bury-buffer buffer))
|
||
|
||
;; Maybe get rid of the window.
|
||
(and window (not window-handled) (not window-solitary)
|
||
(delete-window window))))
|
||
|
||
(define-key ctl-x-map "2" 'split-window-vertically)
|
||
(define-key ctl-x-map "3" 'split-window-horizontally)
|
||
(define-key ctl-x-map "}" 'enlarge-window-horizontally)
|
||
(define-key ctl-x-map "{" 'shrink-window-horizontally)
|
||
(define-key ctl-x-map "-" 'shrink-window-if-larger-than-buffer)
|
||
(define-key ctl-x-map "+" 'balance-windows)
|
||
(define-key ctl-x-4-map "0" 'kill-buffer-and-window)
|
||
|
||
;;; windows.el ends here
|