Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…
Cannot retrieve contributors at this time
237 lines (214 sloc) 8.81 KB
;;; window-numbering --- Numbered window shortcuts
;; Copyright (C) 2006-2007 Nikolaj Schumacher <bugs * nschum , de>
;; Author: Nikolaj Schumacher <bugs * nschum de>
;; Version: 1.1.1
;; Keywords: faces, matching
;; URL:
;; Compatibility: GNU Emacs 22.x
;; This file is NOT part of GNU Emacs.
;; This program 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
;; of the License, or (at your option) any later version.
;; This program is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; GNU General Public License for more details.
;; You should have received a copy of the GNU General Public License
;; along with this program; if not, write to the Free Software
;; Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
;;; Commentary:
;; Enable window-numbering-mode and use M-1 through M-0 to navigate.
;; If you want to affect the numbers, use window-numbering-before-hook or
;; window-numbering-assign-func.
;; For instance, to always assign the calculator window the number 9, add the
;; following to your .emacs:
;; (setq window-numbering-assign-func
;; (lambda () (when (equal (buffer-name) "*Calculator*") 9)))
;;; Changes Log:
;; 2008-04-11 (1.1.1)
;; Added possibility to delete window with prefix arg.
;; Cleaned up code and migrated to `defcustom'.
;; 2007-02-18 (1.1)
;; Added window-numbering-before-hook, window-numbering-assign-func.
;;; Code:
(eval-when-compile (require 'cl))
(push "^No window numbered .$" debug-ignored-errors)
(defgroup window-numbering nil
"Numbered window shortcuts"
:group 'convenience)
(defcustom window-numbering-auto-assign-0-to-minibuffer t
"*If non-nil, `window-numbering-mode' assigns 0 to the minibuffer if active."
:group 'window-numbering
:type '(choice (const :tag "Off" nil)
(const :tag "On" t)))
(defcustom window-numbering-before-hook nil
"*Hook called before `window-numbering-mode' starts assigning numbers.
The number of windows that will be numbered is passed as a parameter.
Use `window-numbering-assign' to manually assign some of them a number.
If you want to assign a number to just one buffer, use
`window-numbering-assign-func' instead."
:group 'window-numbering
:type 'hook)
(defcustom window-numbering-assign-func nil
"*Function called for each window by `window-numbering-mode'.
This is called before automatic assignment begins. The function should
return a number to have it assigned to the current-window, nil otherwise."
:group 'window-numbering
:type 'function)
(defconst window-numbering-mode-line-position 1
"The position in the mode-line `window-numbering-mode' displays the number.")
(defun select-window-by-number (i &optional arg)
"Select window given number I by `window-numbering-mode'.
If prefix ARG is given, delete the window instead of selecting it."
(interactive "P")
(let ((windows (car (gethash (selected-frame) window-numbering-table)))
(if (and (>= i 0) (< i 10)
(setq window (aref windows i)))
(if arg
(delete-window window)
(select-window window))
(error "No window numbered %s" i))))
;; define interactive functions for keymap
(dotimes (i 10)
(eval `(defun ,(intern (format "select-window-%s" i)) (&optional arg)
,(format "Select the window with number %i." i)
(interactive "P")
(select-window-by-number ,i arg))))
(defvar window-numbering-table nil
"table -> (window vector . number table)")
(defun window-numbering-calculate-left (windows)
(let ((i 9) left)
(while (>= i 0)
(let ((window (aref windows i)))
(unless window
(push (% (1+ i) 10) left)))
(decf i))
(defvar window-numbering-windows nil
"A vector listing the window for each number.")
(defvar window-numbering-numbers
"A hash map containing each window's number.")
(defvar window-numbering-left
"A list of unused window numbers.")
(defun window-numbering-assign (window &optional number)
(if number
(if (aref window-numbering-windows number)
(progn (message "Number %s assigned to two buffers (%s and %s)"
number window (aref window-numbering-windows number))
(setf (aref window-numbering-windows number) window)
(puthash window number window-numbering-numbers)
(setq window-numbering-left (delq number window-numbering-left))
;; else default adding
(when window-numbering-left
(unless (gethash window window-numbering-numbers)
(let ((number (car window-numbering-left)))
(window-numbering-assign window number)
(defun window-numbering-update ()
"Update the window numbering for the current frame.
Optional parameter PREASSIGNED-WINDOWS is a hashmap already mapping some
windows to numbers."
(setq window-numbering-windows (make-vector 10 nil)
window-numbering-numbers (make-hash-table :size 10)
(window-numbering-calculate-left window-numbering-windows))
(puthash (selected-frame)
(cons window-numbering-windows window-numbering-numbers)
(when (and window-numbering-auto-assign-0-to-minibuffer
(window-numbering-assign (active-minibuffer-window) 0))
(let ((windows (window-list nil 0 (window-at 0 0))))
(run-hook-with-args 'window-numbering-before-hook windows)
(when window-numbering-assign-func
(mapc `(lambda (window)
(with-selected-window window
(with-current-buffer (window-buffer window)
(let ((num (funcall ,window-numbering-assign-func)))
(when num
(window-numbering-assign window num))))))
(dolist (window windows)
(window-numbering-assign window))))
(defun window-numbering-get-number-string (&optional window)
(int-to-string (window-numbering-get-number window)))
(defun window-numbering-get-number (&optional window)
(gethash (or window (selected-window))
(cdr (gethash (selected-frame) window-numbering-table))))
(defvar window-numbering-keymap
(let ((map (make-sparse-keymap)))
;; (define-key map "\s-0" 'select-window-0)
;; (define-key map "\s-1" 'select-window-1)
;; (define-key map "\s-2" 'select-window-2)
;; (define-key map "\s-3" 'select-window-3)
;; (define-key map "\s-4" 'select-window-4)
;; (define-key map "\s-5" 'select-window-5)
;; (define-key map "\s-6" 'select-window-6)
;; (define-key map "\s-7" 'select-window-7)
;; (define-key map "\s-8" 'select-window-8)
;; (define-key map "\s-9" 'select-window-9)
"Keymap used in by `window-numbering-mode'.")
(define-minor-mode window-numbering-mode
"A minor mode that assigns a number to each window."
nil nil window-numbering-keymap :global t
(if window-numbering-mode
(unless window-numbering-table
(setq window-numbering-table (make-hash-table :size 16))
(add-hook 'window-configuration-change-hook
(dolist (frame (frame-list))
(select-frame frame)
(remove-hook 'window-configuration-change-hook
(setq window-numbering-table nil)))
(defun window-numbering-install-mode-line (&optional position)
"Install the window number from `window-numbering-mode' to the mode-line."
(let ((mode-line (default-value 'mode-line-format))
(dotimes (i (min (or position window-numbering-mode-line-position)
(length mode-line)))
(push (car mode-line) res)
(pop mode-line))
(push '(:eval (window-numbering-get-number-string)) res)
(while mode-line
(push (car mode-line) res)
(pop mode-line))
(setq-default mode-line-format (nreverse res)))
(force-mode-line-update t))
(defun window-numbering-clear-mode-line ()
"Remove the window number of `window-numbering-mode' from the mode-line."
(let ((mode-line (default-value 'mode-line-format))
(while mode-line
(let ((item (car mode-line)))
(unless (equal item '(:eval (window-numbering-get-number-string)))
(push item res)))
(pop mode-line))
(setq-default mode-line-format (nreverse res)))
(force-mode-line-update t))
(provide 'window-numbering)
;;; window-numbering.el ends here
Jump to Line
Something went wrong with that request. Please try again.