File: ace-window.el.html
The main function, ace-window is meant to replace other-window
by assigning each window a short, unique label. When there are only
two windows present, other-window is called (unless
aw-dispatch-always is set non-nil). If there are more, each
window will have its first label character highlighted. Once a
unique label is typed, ace-window will switch to that window.
To setup this package, just add to your .emacs:
(global-set-key (kbd "M-o") 'ace-window)
replacing "M-o" with an appropriate shortcut.
By default, ace-window uses numbers for window labels so the window labeling is intuitively ordered. But if you prefer to type keys on your home row for quicker access, use this setting:
(setq aw-keys '(?a ?s ?d ?f ?g ?h ?j ?k ?l))
Whenever ace-window prompts for a window selection, it grays out all the window characters, highlighting window labels in red. To disable this behavior, set this:
(setq aw-background nil)
If you want to know the selection characters ahead of time, turn on
ace-window-display-mode(var)/ace-window-display-mode(fun).
When prefixed with one universal-argument, instead of switching
to the selected window, the selected window is swapped with the
current one.
When prefixed with two universal-argument, the selected window is
deleted instead.
Defined variables (32)
ace-window-display-mode | Non-nil if Ace-Window-Display mode is enabled. |
ace-window-display-mode-hook | Hook run after entering or leaving ‘ace-window-display-mode’. |
ace-window-mode | Minor mode during the selection process. |
aw--lead-overlay-fn | Function used to display the lead chars. |
aw--remove-leading-chars-fn | Function used to cleanup lead chars. |
aw--window-ring | Hold the window switching history. |
aw--windows-hscroll | List of (window . hscroll-columns) items, each listing a window whose |
aw--windows-points | List of (window . point) items. The point position had to be |
aw-action | Function to call at the end of ‘aw-select’. |
aw-background | When t, ‘ace-window’ will dim out all buffers temporarily when used. |
aw-char-position | Window positions of the character overlay. |
aw-dispatch-alist | List of actions for ‘aw-dispatch-default’. |
aw-dispatch-always | When non-nil, ‘ace-window’ will issue a ‘read-char’ even for one window. |
aw-dispatch-function | Function to call when a character not in ‘aw-keys’ is pressed. |
aw-dispatch-when-more-than | If the number of windows is more than this, activate ace-window-ness. |
aw-display-mode-overlay | When nil, don’t display overlays. Rely on the mode line instead. |
aw-empty-buffers-list | Store the read-only empty buffers which had to be modified. |
aw-fair-aspect-ratio | The aspect ratio to aim for when splitting windows. |
aw-frame-offset | Increase in pixel offset for new ace-window frames relative to the selected frame. |
aw-frame-size | Frame size to make new ace-window frames. |
aw-ignore-current | When t, ‘ace-window’ will ignore ‘selected-window’. |
aw-ignore-on | When t, ‘ace-window’ will ignore buffers and major-modes in ‘aw-ignored-buffers’. |
aw-ignored-buffers | List of buffers and major-modes to ignore when choosing a window from the window list. |
aw-keys | Keys for selecting window. |
aw-leading-char-style | Style of the leading char overlay. |
aw-make-frame-char | Non-existing ace window label character that triggers creation of a new single-window frame for display. |
aw-minibuffer-flag | When non-nil, also display ‘ace-window-mode’ string in the minibuffer when ace-window is active. |
aw-overlays-back | Hold overlays for when ‘aw-background’ is t. |
aw-reverse-frame-list | When non-nil ‘ace-window’ will order frames for selection in |
aw-scope | The scope used by ‘ace-window’. |
aw-swap-invert | When non-nil, the other of the two swapped windows gets the point. |
aw-translate-char-function | Function to translate user input key into another key. |
Defined functions (43)
Defined faces (4)
aw-background-face | Face for whole window background during selection. |
aw-key-face | Face used by ‘aw-show-dispatch-help’. |
aw-minibuffer-leading-char-face | Face for minibuffer leading char. |
aw-mode-line-face | Face used for displaying the ace window key in the mode-line. |