mirror of
https://git.savannah.gnu.org/git/emacs.git
synced 2024-12-29 11:02:01 +00:00
59ce725a3b
Revision: emacs@sv.gnu.org/emacs--devo--0--patch-987
1071 lines
42 KiB
EmacsLisp
1071 lines
42 KiB
EmacsLisp
;;; window.el --- GNU Emacs window commands aside from those written in C
|
||
|
||
;; Copyright (C) 1985, 1989, 1992, 1993, 1994, 2000, 2001, 2002,
|
||
;; 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
|
||
|
||
;; Maintainer: FSF
|
||
;; Keywords: internal
|
||
|
||
;; 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 3, 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., 51 Franklin Street, Fifth Floor,
|
||
;; Boston, MA 02110-1301, USA.
|
||
|
||
;;; Commentary:
|
||
|
||
;; Window tree functions.
|
||
|
||
;;; Code:
|
||
|
||
(defvar window-size-fixed nil
|
||
"*Non-nil in a buffer means windows displaying the buffer are fixed-size.
|
||
If the value is `height', then only the window's height is fixed.
|
||
If the value is `width', then only the window's width is fixed.
|
||
Any other non-nil value fixes both the width and the height.
|
||
Emacs won't change the size of any window displaying that buffer,
|
||
unless you explicitly change the size, or Emacs has no other choice.")
|
||
(make-variable-buffer-local 'window-size-fixed)
|
||
|
||
(defmacro save-selected-window (&rest body)
|
||
"Execute BODY, then select the window that was selected before BODY.
|
||
The value returned is the value of the last form in BODY.
|
||
|
||
This macro saves and restores the current buffer, since otherwise
|
||
its normal operation could potentially make a different
|
||
buffer current. It does not alter the buffer list ordering.
|
||
|
||
This macro saves and restores the selected window, as well as
|
||
the selected window in each frame. If the previously selected
|
||
window of some frame is no longer live at the end of BODY, that
|
||
frame's selected window is left alone. If the selected window is
|
||
no longer live, then whatever window is selected at the end of
|
||
BODY remains selected."
|
||
`(let ((save-selected-window-window (selected-window))
|
||
;; It is necessary to save all of these, because calling
|
||
;; select-window changes frame-selected-window for whatever
|
||
;; frame that window is in.
|
||
(save-selected-window-alist
|
||
(mapcar (lambda (frame) (cons frame (frame-selected-window frame)))
|
||
(frame-list))))
|
||
(save-current-buffer
|
||
(unwind-protect
|
||
(progn ,@body)
|
||
(dolist (elt save-selected-window-alist)
|
||
(and (frame-live-p (car elt))
|
||
(window-live-p (cdr elt))
|
||
(set-frame-selected-window (car elt) (cdr elt))))
|
||
(if (window-live-p save-selected-window-window)
|
||
(select-window save-selected-window-window))))))
|
||
|
||
(defun window-body-height (&optional window)
|
||
"Return number of lines in window WINDOW for actual buffer text.
|
||
This does not include the mode line (if any) or the header line (if any)."
|
||
(or window (setq window (selected-window)))
|
||
(if (window-minibuffer-p window)
|
||
(window-height window)
|
||
(with-current-buffer (window-buffer window)
|
||
(max 1 (- (window-height window)
|
||
(if mode-line-format 1 0)
|
||
(if header-line-format 1 0))))))
|
||
|
||
(defun one-window-p (&optional nomini all-frames)
|
||
"Return non-nil if the selected window is the only window.
|
||
Optional arg NOMINI non-nil means don't count the minibuffer
|
||
even if it is active. Otherwise, the minibuffer is counted
|
||
when 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).
|
||
ALL-FRAMES 0 means count all windows in all visible or iconified frames.
|
||
If ALL-FRAMES is anything else, 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 window-current-scroll-bars (&optional window)
|
||
"Return the current scroll-bar settings in window WINDOW.
|
||
Value is a cons (VERTICAL . HORIZONTAL) where VERTICAL specifies the
|
||
current location of the vertical scroll-bars (left, right, or nil),
|
||
and HORIZONTAL specifies the current location of the horizontal scroll
|
||
bars (top, bottom, or nil)."
|
||
(let ((vert (nth 2 (window-scroll-bars window)))
|
||
(hor nil))
|
||
(when (or (eq vert t) (eq hor t))
|
||
(let ((fcsb (frame-current-scroll-bars
|
||
(window-frame (or window (selected-window))))))
|
||
(if (eq vert t)
|
||
(setq vert (car fcsb)))
|
||
(if (eq hor t)
|
||
(setq hor (cdr fcsb)))))
|
||
(cons vert hor)))
|
||
|
||
(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 only if
|
||
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.
|
||
If ALL-FRAMES is a frame, it means include windows on that frame.
|
||
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))
|
||
(save-selected-window
|
||
(if (framep all-frames)
|
||
(select-window (frame-first-window all-frames)))
|
||
(let* (walk-windows-already-seen
|
||
(walk-windows-current (selected-window)))
|
||
(while (progn
|
||
(setq walk-windows-current
|
||
(next-window walk-windows-current minibuf all-frames))
|
||
(not (memq walk-windows-current walk-windows-already-seen)))
|
||
(setq walk-windows-already-seen
|
||
(cons walk-windows-current walk-windows-already-seen))
|
||
(funcall proc walk-windows-current)))))
|
||
|
||
(defun get-window-with-predicate (predicate &optional minibuf
|
||
all-frames default)
|
||
"Return a window satisfying PREDICATE.
|
||
|
||
This function cycles through all visible windows using `walk-windows',
|
||
calling PREDICATE on each one. PREDICATE is called with a window as
|
||
argument. The first window for which PREDICATE returns a non-nil
|
||
value is returned. If no window satisfies PREDICATE, DEFAULT is
|
||
returned.
|
||
|
||
Optional second arg MINIBUF t means count the minibuffer window even
|
||
if not active. MINIBUF nil or omitted means count the minibuffer only if
|
||
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.
|
||
If ALL-FRAMES is a frame, it means include windows on that frame.
|
||
Anything else means restrict to the selected frame."
|
||
(catch 'found
|
||
(walk-windows #'(lambda (window)
|
||
(when (funcall predicate window)
|
||
(throw 'found window)))
|
||
minibuf all-frames)
|
||
default))
|
||
|
||
(defalias 'some-window 'get-window-with-predicate)
|
||
|
||
;; This should probably be written in C (i.e., without using `walk-windows').
|
||
(defun get-buffer-window-list (buffer &optional minibuf frame)
|
||
"Return list of all windows displaying BUFFER, or nil if none.
|
||
BUFFER can be a buffer or a buffer name.
|
||
See `walk-windows' for the meaning of MINIBUF and FRAME."
|
||
(let ((buffer (if (bufferp buffer) buffer (get-buffer buffer))) windows)
|
||
(walk-windows (function (lambda (window)
|
||
(if (eq (window-buffer window) buffer)
|
||
(setq windows (cons window windows)))))
|
||
minibuf frame)
|
||
windows))
|
||
|
||
(defun minibuffer-window-active-p (window)
|
||
"Return t if WINDOW (a minibuffer window) is now active."
|
||
(eq window (active-minibuffer-window)))
|
||
|
||
(defun count-windows (&optional minibuf)
|
||
"Return 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 (lambda (w) (setq count (+ count 1)))
|
||
minibuf)
|
||
count))
|
||
|
||
(defun window-safely-shrinkable-p (&optional window)
|
||
"Non-nil if the WINDOW can be shrunk without shrinking other windows.
|
||
If WINDOW is nil or omitted, it defaults to the currently selected window."
|
||
(with-selected-window (or window (selected-window))
|
||
(let ((edges (window-edges)))
|
||
(or (= (nth 2 edges) (nth 2 (window-edges (previous-window))))
|
||
(= (nth 0 edges) (nth 0 (window-edges (next-window))))))))
|
||
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
;;; `balance-windows' subroutines using `window-tree'
|
||
|
||
;;; Translate from internal window tree format
|
||
|
||
(defun bw-get-tree (&optional window-or-frame)
|
||
"Get a window split tree in our format.
|
||
|
||
WINDOW-OR-FRAME must be nil, a frame, or a window. If it is nil,
|
||
then the whole window split tree for `selected-frame' is returned.
|
||
If it is a frame, then this is used instead. If it is a window,
|
||
then the smallest tree containing that window is returned."
|
||
(when window-or-frame
|
||
(unless (or (framep window-or-frame)
|
||
(windowp window-or-frame))
|
||
(error "Not a frame or window: %s" window-or-frame)))
|
||
(let ((subtree (bw-find-tree-sub window-or-frame)))
|
||
(when subtree
|
||
(if (integerp subtree)
|
||
nil
|
||
(bw-get-tree-1 subtree)))))
|
||
|
||
(defun bw-get-tree-1 (split)
|
||
(if (windowp split)
|
||
split
|
||
(let ((dir (car split))
|
||
(edges (car (cdr split)))
|
||
(childs (cdr (cdr split))))
|
||
(list
|
||
(cons 'dir (if dir 'ver 'hor))
|
||
(cons 'b (nth 3 edges))
|
||
(cons 'r (nth 2 edges))
|
||
(cons 't (nth 1 edges))
|
||
(cons 'l (nth 0 edges))
|
||
(cons 'childs (mapcar #'bw-get-tree-1 childs))))))
|
||
|
||
(defun bw-find-tree-sub (window-or-frame &optional get-parent)
|
||
(let* ((window (when (windowp window-or-frame) window-or-frame))
|
||
(frame (when (windowp window) (window-frame window)))
|
||
(wt (car (window-tree frame))))
|
||
(when (< 1 (length (window-list frame 0)))
|
||
(if window
|
||
(bw-find-tree-sub-1 wt window get-parent)
|
||
wt))))
|
||
|
||
(defun bw-find-tree-sub-1 (tree win &optional get-parent)
|
||
(unless (windowp win) (error "Not a window: %s" win))
|
||
(if (memq win tree)
|
||
(if get-parent
|
||
get-parent
|
||
tree)
|
||
(let ((childs (cdr (cdr tree)))
|
||
child
|
||
subtree)
|
||
(while (and childs (not subtree))
|
||
(setq child (car childs))
|
||
(setq childs (cdr childs))
|
||
(when (and child (listp child))
|
||
(setq subtree (bw-find-tree-sub-1 child win get-parent))))
|
||
(if (integerp subtree)
|
||
(progn
|
||
(if (= 1 subtree)
|
||
tree
|
||
(1- subtree)))
|
||
subtree
|
||
))))
|
||
|
||
;;; Window or object edges
|
||
|
||
(defun bw-l (obj)
|
||
"Left edge of OBJ."
|
||
(if (windowp obj) (nth 0 (window-edges obj)) (cdr (assq 'l obj))))
|
||
(defun bw-t (obj)
|
||
"Top edge of OBJ."
|
||
(if (windowp obj) (nth 1 (window-edges obj)) (cdr (assq 't obj))))
|
||
(defun bw-r (obj)
|
||
"Right edge of OBJ."
|
||
(if (windowp obj) (nth 2 (window-edges obj)) (cdr (assq 'r obj))))
|
||
(defun bw-b (obj)
|
||
"Bottom edge of OBJ."
|
||
(if (windowp obj) (nth 3 (window-edges obj)) (cdr (assq 'b obj))))
|
||
|
||
;;; Split directions
|
||
|
||
(defun bw-dir (obj)
|
||
"Return window split tree direction if OBJ.
|
||
If OBJ is a window return 'both. If it is a window split tree
|
||
then return its direction."
|
||
(if (symbolp obj)
|
||
obj
|
||
(if (windowp obj)
|
||
'both
|
||
(let ((dir (cdr (assq 'dir obj))))
|
||
(unless (memq dir '(hor ver both))
|
||
(error "Can't find dir in %s" obj))
|
||
dir))))
|
||
|
||
(defun bw-eqdir (obj1 obj2)
|
||
"Return t if window split tree directions are equal.
|
||
OBJ1 and OBJ2 should be either windows or window split trees in
|
||
our format. The directions returned by `bw-dir' are compared and
|
||
t is returned if they are `eq' or one of them is 'both."
|
||
(let ((dir1 (bw-dir obj1))
|
||
(dir2 (bw-dir obj2)))
|
||
(or (eq dir1 dir2)
|
||
(eq dir1 'both)
|
||
(eq dir2 'both))))
|
||
|
||
;;; Building split tree
|
||
|
||
(defun bw-refresh-edges (obj)
|
||
"Refresh the edge information of OBJ and return OBJ."
|
||
(unless (windowp obj)
|
||
(let ((childs (cdr (assq 'childs obj)))
|
||
(ol 1000)
|
||
(ot 1000)
|
||
(or -1)
|
||
(ob -1))
|
||
(dolist (o childs)
|
||
(when (> ol (bw-l o)) (setq ol (bw-l o)))
|
||
(when (> ot (bw-t o)) (setq ot (bw-t o)))
|
||
(when (< or (bw-r o)) (setq or (bw-r o)))
|
||
(when (< ob (bw-b o)) (setq ob (bw-b o))))
|
||
(setq obj (delq 'l obj))
|
||
(setq obj (delq 't obj))
|
||
(setq obj (delq 'r obj))
|
||
(setq obj (delq 'b obj))
|
||
(add-to-list 'obj (cons 'l ol))
|
||
(add-to-list 'obj (cons 't ot))
|
||
(add-to-list 'obj (cons 'r or))
|
||
(add-to-list 'obj (cons 'b ob))
|
||
))
|
||
obj)
|
||
|
||
;;; Balance windows
|
||
|
||
(defun balance-windows (&optional window-or-frame)
|
||
"Make windows the same heights or widths in window split subtrees.
|
||
|
||
When called non-interactively WINDOW-OR-FRAME may be either a
|
||
window or a frame. It then balances the windows on the implied
|
||
frame. If the parameter is a window only the corresponding window
|
||
subtree is balanced."
|
||
(interactive)
|
||
(let (
|
||
(wt (bw-get-tree window-or-frame))
|
||
(w)
|
||
(h)
|
||
(tried-sizes)
|
||
(last-sizes)
|
||
(windows (window-list nil 0)))
|
||
(when wt
|
||
(while (not (member last-sizes tried-sizes))
|
||
(when last-sizes (setq tried-sizes (cons last-sizes tried-sizes)))
|
||
(setq last-sizes (mapcar (lambda (w)
|
||
(window-edges w))
|
||
windows))
|
||
(when (eq 'hor (bw-dir wt))
|
||
(setq w (- (bw-r wt) (bw-l wt))))
|
||
(when (eq 'ver (bw-dir wt))
|
||
(setq h (- (bw-b wt) (bw-t wt))))
|
||
(bw-balance-sub wt w h)))))
|
||
|
||
(defun bw-adjust-window (window delta horizontal)
|
||
"Wrapper around `adjust-window-trailing-edge' with error checking.
|
||
Arguments WINDOW, DELTA and HORIZONTAL are passed on to that function."
|
||
;; `adjust-window-trailing-edge' may fail if delta is too large.
|
||
(while (>= (abs delta) 1)
|
||
(condition-case err
|
||
(progn
|
||
(adjust-window-trailing-edge window delta horizontal)
|
||
(setq delta 0))
|
||
(error
|
||
;;(message "adjust: %s" (error-message-string err))
|
||
(setq delta (/ delta 2))))))
|
||
|
||
(defun bw-balance-sub (wt w h)
|
||
(setq wt (bw-refresh-edges wt))
|
||
(unless w (setq w (- (bw-r wt) (bw-l wt))))
|
||
(unless h (setq h (- (bw-b wt) (bw-t wt))))
|
||
(if (windowp wt)
|
||
(progn
|
||
(when w
|
||
(let ((dw (- w (- (bw-r wt) (bw-l wt)))))
|
||
(when (/= 0 dw)
|
||
(bw-adjust-window wt dw t))))
|
||
(when h
|
||
(let ((dh (- h (- (bw-b wt) (bw-t wt)))))
|
||
(when (/= 0 dh)
|
||
(bw-adjust-window wt dh nil)))))
|
||
(let* ((childs (cdr (assq 'childs wt)))
|
||
(cw (when w (/ w (if (bw-eqdir 'hor wt) (length childs) 1))))
|
||
(ch (when h (/ h (if (bw-eqdir 'ver wt) (length childs) 1)))))
|
||
(dolist (c childs)
|
||
(bw-balance-sub c cw ch)))))
|
||
|
||
;;; A different solution to balance-windows
|
||
|
||
(defun window-fixed-size-p (&optional window direction)
|
||
"Non-nil if WINDOW cannot be resized in DIRECTION.
|
||
DIRECTION can be nil (i.e. any), `height' or `width'."
|
||
(with-current-buffer (window-buffer window)
|
||
(let ((fixed (and (boundp 'window-size-fixed) window-size-fixed)))
|
||
(when fixed
|
||
(not (and direction
|
||
(member (cons direction window-size-fixed)
|
||
'((height . width) (width . height)))))))))
|
||
|
||
(defvar window-area-factor 1
|
||
"Factor by which the window area should be over-estimated.
|
||
This is used by `balance-windows-area'.
|
||
Changing this globally has no effect.")
|
||
|
||
(defun balance-windows-area ()
|
||
"Make all visible windows the same area (approximately).
|
||
See also `window-area-factor' to change the relative size of specific buffers."
|
||
(interactive)
|
||
(let* ((unchanged 0) (carry 0) (round 0)
|
||
;; Remove fixed-size windows.
|
||
(wins (delq nil (mapcar (lambda (win)
|
||
(if (not (window-fixed-size-p win)) win))
|
||
(window-list nil 'nomini))))
|
||
(changelog nil)
|
||
next)
|
||
;; Resizing a window changes the size of surrounding windows in complex
|
||
;; ways, so it's difficult to balance them all. The introduction of
|
||
;; `adjust-window-trailing-edge' made it a bit easier, but it is still
|
||
;; very difficult to do. `balance-window' above takes an off-line
|
||
;; approach: get the whole window tree, then balance it, then try to
|
||
;; adjust the windows so they fit the result.
|
||
;; Here, instead, we take a "local optimization" approach, where we just
|
||
;; go through all the windows several times until nothing needs to be
|
||
;; changed. The main problem with this approach is that it's difficult
|
||
;; to make sure it terminates, so we use some heuristic to try and break
|
||
;; off infinite loops.
|
||
;; After a round without any change, we allow a second, to give a chance
|
||
;; to the carry to propagate a minor imbalance from the end back to
|
||
;; the beginning.
|
||
(while (< unchanged 2)
|
||
;; (message "New round")
|
||
(setq unchanged (1+ unchanged) round (1+ round))
|
||
(dolist (win wins)
|
||
(setq next win)
|
||
(while (progn (setq next (next-window next))
|
||
(window-fixed-size-p next)))
|
||
;; (assert (eq next (or (cadr (member win wins)) (car wins))))
|
||
(let* ((horiz
|
||
(< (car (window-edges win)) (car (window-edges next))))
|
||
(areadiff (/ (- (* (window-height next) (window-width next)
|
||
(buffer-local-value 'window-area-factor
|
||
(window-buffer next)))
|
||
(* (window-height win) (window-width win)
|
||
(buffer-local-value 'window-area-factor
|
||
(window-buffer win))))
|
||
(max (buffer-local-value 'window-area-factor
|
||
(window-buffer win))
|
||
(buffer-local-value 'window-area-factor
|
||
(window-buffer next)))))
|
||
(edgesize (if horiz
|
||
(+ (window-height win) (window-height next))
|
||
(+ (window-width win) (window-width next))))
|
||
(diff (/ areadiff edgesize)))
|
||
(when (zerop diff)
|
||
;; Maybe diff is actually closer to 1 than to 0.
|
||
(setq diff (/ (* 3 areadiff) (* 2 edgesize))))
|
||
(when (and (zerop diff) (not (zerop areadiff)))
|
||
(setq diff (/ (+ areadiff carry) edgesize))
|
||
;; Change things smoothly.
|
||
(if (or (> diff 1) (< diff -1)) (setq diff (/ diff 2))))
|
||
(if (zerop diff)
|
||
;; Make sure negligible differences don't accumulate to
|
||
;; become significant.
|
||
(setq carry (+ carry areadiff))
|
||
(bw-adjust-window win diff horiz)
|
||
;; (sit-for 0.5)
|
||
(let ((change (cons win (window-edges win))))
|
||
;; If the same change has been seen already for this window,
|
||
;; we're most likely in an endless loop, so don't count it as
|
||
;; a change.
|
||
(unless (member change changelog)
|
||
(push change changelog)
|
||
(setq unchanged 0 carry 0)))))))
|
||
;; We've now basically balanced all the windows.
|
||
;; But there may be some minor off-by-one imbalance left over,
|
||
;; so let's do some fine tuning.
|
||
;; (bw-finetune wins)
|
||
;; (message "Done in %d rounds" round)
|
||
))
|
||
|
||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
||
;; I think this should be the default; I think people will prefer it--rms.
|
||
(defcustom split-window-keep-point t
|
||
"*If non-nil, \\[split-window-vertically] 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.
|
||
|
||
This option applies only to `split-window-vertically' and
|
||
functions that call it. `split-window' always keeps the original
|
||
point in both children."
|
||
: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. The upper window is the selected window.
|
||
|
||
Otherwise, we choose 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.
|
||
|
||
Regardless of the value of `split-window-keep-point', the upper
|
||
window is the original one and the return value is the new, lower
|
||
window."
|
||
(interactive "P")
|
||
(let ((old-w (selected-window))
|
||
(old-point (point))
|
||
(size (and arg (prefix-numeric-value arg)))
|
||
(window-full-p nil)
|
||
new-w bottom 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)
|
||
(with-current-buffer (window-buffer)
|
||
(if view-mode
|
||
(let ((old-info (assq old-w view-return-to-alist)))
|
||
(if old-info
|
||
(push (cons new-w (cons (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.
|
||
|
||
The original, leftmost window remains selected.
|
||
The return value is the new, rightmost window."
|
||
(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 set-window-text-height (window height)
|
||
"Sets the height in lines of the text display area of WINDOW to HEIGHT.
|
||
This doesn't include the mode-line (or header-line if any) or any
|
||
partial-height lines in the text display area.
|
||
|
||
If WINDOW is nil, the selected window is used.
|
||
|
||
Note that the current implementation of this function cannot always set
|
||
the height exactly, but attempts to be conservative, by allocating more
|
||
lines than are actually needed in the case where some error may be present."
|
||
(let ((delta (- height (window-text-height window))))
|
||
(unless (zerop delta)
|
||
;; Setting window-min-height to a value like 1 can lead to very
|
||
;; bizarre displays because it also allows Emacs to make *other*
|
||
;; windows 1-line tall, which means that there's no more space for
|
||
;; the modeline.
|
||
(let ((window-min-height (min 2 height))) ;One text line plus a modeline.
|
||
(if (and window (not (eq window (selected-window))))
|
||
(save-selected-window
|
||
(select-window window)
|
||
(enlarge-window delta))
|
||
(enlarge-window delta))))))
|
||
|
||
|
||
(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."
|
||
(with-current-buffer (window-buffer window)
|
||
(max 1
|
||
(count-screen-lines (point-min) (point-max)
|
||
;; If buffer ends with a newline, ignore it when
|
||
;; counting height unless point is after it.
|
||
(eobp)
|
||
window))))
|
||
|
||
(defun count-screen-lines (&optional beg end count-final-newline window)
|
||
"Return the number of screen lines in the region.
|
||
The number of screen lines may be different from the number of actual lines,
|
||
due to line breaking, display table, etc.
|
||
|
||
Optional arguments BEG and END default to `point-min' and `point-max'
|
||
respectively.
|
||
|
||
If region ends with a newline, ignore it unless optional third argument
|
||
COUNT-FINAL-NEWLINE is non-nil.
|
||
|
||
The optional fourth argument WINDOW specifies the window used for obtaining
|
||
parameters such as width, horizontal scrolling, and so on. The default is
|
||
to use the selected window's parameters.
|
||
|
||
Like `vertical-motion', `count-screen-lines' always uses the current buffer,
|
||
regardless of which buffer is displayed in WINDOW. This makes possible to use
|
||
`count-screen-lines' in any buffer, whether or not it is currently displayed
|
||
in some window."
|
||
(unless beg
|
||
(setq beg (point-min)))
|
||
(unless end
|
||
(setq end (point-max)))
|
||
(if (= beg end)
|
||
0
|
||
(save-excursion
|
||
(save-restriction
|
||
(widen)
|
||
(narrow-to-region (min beg end)
|
||
(if (and (not count-final-newline)
|
||
(= ?\n (char-before (max beg end))))
|
||
(1- (max beg end))
|
||
(max beg end)))
|
||
(goto-char (point-min))
|
||
(1+ (vertical-motion (buffer-size) window))))))
|
||
|
||
(defun fit-window-to-buffer (&optional window max-height min-height)
|
||
"Make WINDOW the right height to display its contents exactly.
|
||
If WINDOW is omitted or nil, it defaults to the selected window.
|
||
If the optional argument MAX-HEIGHT is supplied, it is the maximum height
|
||
the window is allowed to be, defaulting to the frame height.
|
||
If the optional argument MIN-HEIGHT is supplied, it is the minimum
|
||
height the window is allowed to be, defaulting to `window-min-height'.
|
||
|
||
The heights in MAX-HEIGHT and MIN-HEIGHT include the mode-line and/or
|
||
header-line."
|
||
(interactive)
|
||
|
||
(when (null window)
|
||
(setq window (selected-window)))
|
||
(when (null max-height)
|
||
(setq max-height (frame-height (window-frame window))))
|
||
|
||
(let* ((buf
|
||
;; Buffer that is displayed in WINDOW
|
||
(window-buffer window))
|
||
(window-height
|
||
;; The current height of WINDOW
|
||
(window-height window))
|
||
(desired-height
|
||
;; The height necessary to show the buffer displayed by WINDOW
|
||
;; (`count-screen-lines' always works on the current buffer).
|
||
(with-current-buffer buf
|
||
(+ (count-screen-lines)
|
||
;; If the buffer is empty, (count-screen-lines) is
|
||
;; zero. But, even in that case, we need one text line
|
||
;; for cursor.
|
||
(if (= (point-min) (point-max))
|
||
1 0)
|
||
;; For non-minibuffers, count the mode-line, if any
|
||
(if (and (not (window-minibuffer-p window))
|
||
mode-line-format)
|
||
1 0)
|
||
;; Count the header-line, if any
|
||
(if header-line-format 1 0))))
|
||
(delta
|
||
;; Calculate how much the window height has to change to show
|
||
;; desired-height lines, constrained by MIN-HEIGHT and MAX-HEIGHT.
|
||
(- (max (min desired-height max-height)
|
||
(or min-height window-min-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 (with-current-buffer buf
|
||
(and (eobp) (bolp) (not (bobp))))
|
||
(set-window-point window (1- (window-point window))))
|
||
|
||
(save-selected-window
|
||
(select-window window)
|
||
|
||
;; Adjust WINDOW to the nominally correct size (which may actually
|
||
;; be slightly off because of variable height text, etc).
|
||
(unless (zerop delta)
|
||
(enlarge-window delta))
|
||
|
||
;; Check if the last line is surely fully visible. If not,
|
||
;; enlarge the window.
|
||
(let ((end (with-current-buffer buf
|
||
(save-excursion
|
||
(goto-char (point-max))
|
||
(when (and (bolp) (not (bobp)))
|
||
;; Don't include final newline
|
||
(backward-char 1))
|
||
(when truncate-lines
|
||
;; If line-wrapping is turned off, test the
|
||
;; beginning of the last line for visibility
|
||
;; instead of the end, as the end of the line
|
||
;; could be invisible by virtue of extending past
|
||
;; the edge of the window.
|
||
(forward-line 0))
|
||
(point)))))
|
||
(set-window-vscroll window 0)
|
||
(while (and (< desired-height max-height)
|
||
(= desired-height (window-height window))
|
||
(not (pos-visible-in-window-p end window)))
|
||
(enlarge-window 1)
|
||
(setq desired-height (1+ desired-height)))))))
|
||
|
||
(defun shrink-window-if-larger-than-buffer (&optional window)
|
||
"Shrink the WINDOW to be as small as possible to display its contents.
|
||
If WINDOW is omitted or nil, it defaults to the selected window.
|
||
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 shrinking this window would also shrink another window,
|
||
or if the window is the only window of its frame."
|
||
(interactive)
|
||
(when (null window)
|
||
(setq window (selected-window)))
|
||
(let* ((frame (window-frame window))
|
||
(mini (frame-parameter frame 'minibuffer))
|
||
(edges (window-edges window)))
|
||
(if (and (not (eq window (frame-root-window frame)))
|
||
(window-safely-shrinkable-p)
|
||
(pos-visible-in-window-p (point-min) window)
|
||
(not (eq mini 'only))
|
||
(or (not mini)
|
||
(let ((mini-window (minibuffer-window frame)))
|
||
(or (null mini-window)
|
||
(not (eq frame (window-frame mini-window)))
|
||
(< (nth 3 edges)
|
||
(nth 1 (window-edges mini-window)))
|
||
(> (nth 1 edges)
|
||
(frame-parameter frame 'menu-bar-lines))))))
|
||
(fit-window-to-buffer window (window-height window)))))
|
||
|
||
(defun kill-buffer-and-window ()
|
||
"Kill the current buffer and delete the selected window."
|
||
(interactive)
|
||
(let ((window-to-delete (selected-window))
|
||
(buffer-to-kill (current-buffer))
|
||
(delete-window-hook (lambda ()
|
||
(condition-case nil
|
||
(delete-window)
|
||
(error nil)))))
|
||
(unwind-protect
|
||
(progn
|
||
(add-hook 'kill-buffer-hook delete-window-hook t t)
|
||
(if (kill-buffer (current-buffer))
|
||
;; If `delete-window' failed before, we rerun it to regenerate
|
||
;; the error so it can be seen in the echo area.
|
||
(when (eq (selected-window) window-to-delete)
|
||
(delete-window))))
|
||
;; If the buffer is not dead for some reason (probably because
|
||
;; of a `quit' signal), remove the hook again.
|
||
(condition-case nil
|
||
(with-current-buffer buffer-to-kill
|
||
(remove-hook 'kill-buffer-hook delete-window-hook t))
|
||
(error nil)))))
|
||
|
||
(defun quit-window (&optional kill window)
|
||
"Quit the current buffer. Bury it, and maybe delete the selected frame.
|
||
\(The frame is deleted if it 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))))
|
||
|
||
(defvar recenter-last-op nil
|
||
"Indicates the last recenter operation performed.
|
||
Possible values: `top', `middle', `bottom'.")
|
||
|
||
(defun recenter-top-bottom (&optional arg)
|
||
"Move current line to window center, top, and bottom, successively.
|
||
With a prefix argument, this is the same as `recenter':
|
||
With numeric prefix ARG, move current line to window-line ARG.
|
||
With plain `C-u', move current line to window center.
|
||
|
||
Otherwise move current line to window center on first call, and to
|
||
top, middle, or bottom on successive calls.
|
||
|
||
The cycling order is: middle -> top -> bottom.
|
||
|
||
Top and bottom destinations are actually `scroll-conservatively' lines
|
||
from true window top and bottom."
|
||
(interactive "P")
|
||
(cond
|
||
(arg (recenter arg)) ; Always respect ARG.
|
||
((not (eq this-command last-command))
|
||
;; First time - save mode and recenter.
|
||
(setq recenter-last-op 'middle)
|
||
(recenter))
|
||
(t ;; repeat: loop through various options.
|
||
(setq recenter-last-op
|
||
(cond ((eq recenter-last-op 'middle)
|
||
(recenter scroll-conservatively)
|
||
'top)
|
||
((eq recenter-last-op 'top)
|
||
(recenter (1- (- scroll-conservatively)))
|
||
'bottom)
|
||
((eq recenter-last-op 'bottom)
|
||
(recenter)
|
||
'middle))))))
|
||
|
||
(define-key global-map [?\C-l] 'recenter-top-bottom)
|
||
|
||
(defvar mouse-autoselect-window-timer nil
|
||
"Timer used by delayed window autoselection.")
|
||
|
||
(defvar mouse-autoselect-window-position nil
|
||
"Last mouse position recorded by delayed window autoselection.")
|
||
|
||
(defvar mouse-autoselect-window-window nil
|
||
"Last window recorded by delayed window autoselection.")
|
||
|
||
(defvar mouse-autoselect-window-state nil
|
||
"When non-nil, special state of delayed window autoselection.
|
||
Possible values are `suspend' \(suspend autoselection after a menu or
|
||
scrollbar interaction\) and `select' \(the next invocation of
|
||
'handle-select-window' shall select the window immediately\).")
|
||
|
||
(defun mouse-autoselect-window-cancel (&optional force)
|
||
"Cancel delayed window autoselection.
|
||
Optional argument FORCE means cancel unconditionally."
|
||
(unless (and (not force)
|
||
;; Don't cancel for select-window or select-frame events
|
||
;; or when the user drags a scroll bar.
|
||
(or (memq this-command
|
||
'(handle-select-window handle-switch-frame))
|
||
(and (eq this-command 'scroll-bar-toolkit-scroll)
|
||
(memq (nth 4 (event-end last-input-event))
|
||
'(handle end-scroll)))))
|
||
(setq mouse-autoselect-window-state nil)
|
||
(when (timerp mouse-autoselect-window-timer)
|
||
(cancel-timer mouse-autoselect-window-timer))
|
||
(remove-hook 'pre-command-hook 'mouse-autoselect-window-cancel)))
|
||
|
||
(defun mouse-autoselect-window-start (mouse-position &optional window suspend)
|
||
"Start delayed window autoselection.
|
||
MOUSE-POSITION is the last position where the mouse was seen as returned
|
||
by `mouse-position'. Optional argument WINDOW non-nil denotes the
|
||
window where the mouse was seen. Optional argument SUSPEND non-nil
|
||
means suspend autoselection."
|
||
;; Record values for MOUSE-POSITION, WINDOW, and SUSPEND.
|
||
(setq mouse-autoselect-window-position mouse-position)
|
||
(when window (setq mouse-autoselect-window-window window))
|
||
(setq mouse-autoselect-window-state (when suspend 'suspend))
|
||
;; Install timer which runs `mouse-autoselect-window-select' after
|
||
;; `mouse-autoselect-window' seconds.
|
||
(setq mouse-autoselect-window-timer
|
||
(run-at-time
|
||
(abs mouse-autoselect-window) nil 'mouse-autoselect-window-select)))
|
||
|
||
(defun mouse-autoselect-window-select ()
|
||
"Select window with delayed window autoselection.
|
||
If the mouse position has stabilized in a non-selected window, select
|
||
that window. The minibuffer window is selected only if the minibuffer is
|
||
active. This function is run by `mouse-autoselect-window-timer'."
|
||
(condition-case nil
|
||
(let* ((mouse-position (mouse-position))
|
||
(window
|
||
(condition-case nil
|
||
(window-at (cadr mouse-position) (cddr mouse-position)
|
||
(car mouse-position))
|
||
(error nil))))
|
||
(cond
|
||
((or (menu-or-popup-active-p)
|
||
(and window
|
||
(not (coordinates-in-window-p (cdr mouse-position) window))))
|
||
;; A menu / popup dialog is active or the mouse is on the scroll-bar
|
||
;; of WINDOW, temporarily suspend delayed autoselection.
|
||
(mouse-autoselect-window-start mouse-position nil t))
|
||
((eq mouse-autoselect-window-state 'suspend)
|
||
;; Delayed autoselection was temporarily suspended, reenable it.
|
||
(mouse-autoselect-window-start mouse-position))
|
||
((and window (not (eq window (selected-window)))
|
||
(or (not (numberp mouse-autoselect-window))
|
||
(and (> mouse-autoselect-window 0)
|
||
;; If `mouse-autoselect-window' is positive, select
|
||
;; window if the window is the same as before.
|
||
(eq window mouse-autoselect-window-window))
|
||
;; Otherwise select window if the mouse is at the same
|
||
;; position as before. Observe that the first test after
|
||
;; starting autoselection usually fails since the value of
|
||
;; `mouse-autoselect-window-position' recorded there is the
|
||
;; position where the mouse has entered the new window and
|
||
;; not necessarily where the mouse has stopped moving.
|
||
(equal mouse-position mouse-autoselect-window-position))
|
||
;; The minibuffer is a candidate window if it's active.
|
||
(or (not (window-minibuffer-p window))
|
||
(eq window (active-minibuffer-window))))
|
||
;; Mouse position has stabilized in non-selected window: Cancel
|
||
;; delayed autoselection and try to select that window.
|
||
(mouse-autoselect-window-cancel t)
|
||
;; Select window where mouse appears unless the selected window is the
|
||
;; minibuffer. Use `unread-command-events' in order to execute pre-
|
||
;; and post-command hooks and trigger idle timers. To avoid delaying
|
||
;; autoselection again, set `mouse-autoselect-window-state'."
|
||
(unless (window-minibuffer-p (selected-window))
|
||
(setq mouse-autoselect-window-state 'select)
|
||
(setq unread-command-events
|
||
(cons (list 'select-window (list window))
|
||
unread-command-events))))
|
||
((or (and window (eq window (selected-window)))
|
||
(not (numberp mouse-autoselect-window))
|
||
(equal mouse-position mouse-autoselect-window-position))
|
||
;; Mouse position has either stabilized in the selected window or at
|
||
;; `mouse-autoselect-window-position': Cancel delayed autoselection.
|
||
(mouse-autoselect-window-cancel t))
|
||
(t
|
||
;; Mouse position has not stabilized yet, resume delayed
|
||
;; autoselection.
|
||
(mouse-autoselect-window-start mouse-position window))))
|
||
(error nil)))
|
||
|
||
(defun handle-select-window (event)
|
||
"Handle select-window events."
|
||
(interactive "e")
|
||
(let ((window (posn-window (event-start event))))
|
||
(unless (or (not (window-live-p window))
|
||
;; Don't switch if we're currently in the minibuffer.
|
||
;; This tries to work around problems where the
|
||
;; minibuffer gets unselected unexpectedly, and where
|
||
;; you then have to move your mouse all the way down to
|
||
;; the minibuffer to select it.
|
||
(window-minibuffer-p (selected-window))
|
||
;; Don't switch to minibuffer window unless it's active.
|
||
(and (window-minibuffer-p window)
|
||
(not (minibuffer-window-active-p window)))
|
||
;; Don't switch when autoselection shall be delayed.
|
||
(and (numberp mouse-autoselect-window)
|
||
(not (zerop mouse-autoselect-window))
|
||
(not (eq mouse-autoselect-window-state 'select))
|
||
(progn
|
||
;; Cancel any delayed autoselection.
|
||
(mouse-autoselect-window-cancel t)
|
||
;; Start delayed autoselection from current mouse position
|
||
;; and window.
|
||
(mouse-autoselect-window-start (mouse-position) window)
|
||
;; Executing a command cancels delayed autoselection.
|
||
(add-hook
|
||
'pre-command-hook 'mouse-autoselect-window-cancel))))
|
||
(when mouse-autoselect-window
|
||
;; Reset state of delayed autoselection.
|
||
(setq mouse-autoselect-window-state nil)
|
||
;; Run `mouse-leave-buffer-hook' when autoselecting window.
|
||
(run-hooks 'mouse-leave-buffer-hook))
|
||
(select-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)
|
||
|
||
;; arch-tag: b508dfcc-c353-4c37-89fa-e773fe10cea9
|
||
;;; window.el ends here
|