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-modeNon-nil if Ace-Window-Display mode is enabled.
ace-window-display-mode-hook
ace-window-mode
aw--lead-overlay-fn
aw--remove-leading-chars-fn
aw--window-ring
aw--windows-hscroll
aw--windows-points
aw-action
aw-background
aw-char-position
aw-dispatch-alist
aw-dispatch-always
aw-dispatch-function
aw-dispatch-when-more-than
aw-display-mode-overlay
aw-empty-buffers-list
aw-fair-aspect-ratio
aw-frame-offset
aw-frame-size
aw-ignore-current
aw-ignore-on
aw-ignored-buffers
aw-keys
aw-leading-char-style
aw-make-frame-char
aw-minibuffer-flag
aw-overlays-back
aw-reverse-frame-list
aw-scope
aw-swap-invert
aw-translate-char-function

Defined functions (43)

ace-delete-other-windows[Arg list not available until function definition is loaded.]
ace-delete-window[Arg list not available until function definition is loaded.]
ace-display-buffer(BUFFER ALIST)
ace-select-window[Arg list not available until function definition is loaded.]
ace-swap-window[Arg list not available until function definition is loaded.]
ace-window(ARG)
ace-window-display-mode(&optional ARG)
aw--after-make-frame
aw--dispatch-action
aw--done
aw--lead-overlay
aw--make-backgrounds
aw--overlay-str
aw--point-visible-p
aw--pop-window
aw--push-window
aw--restore-windows-hscroll
aw-clean-up-avy-current-path
aw-copy-window
aw-delete-window
aw-dispatch-default
aw-execute-command-other-window
aw-flip-window
aw-ignored-p
aw-make-frame
aw-move-window
aw-offset
aw-select
aw-set-make-frame-char
aw-set-mode-line
aw-show-dispatch-help
aw-split-window-fair
aw-split-window-horz
aw-split-window-vert
aw-swap-window
aw-switch-buffer-in-window
aw-switch-buffer-other-window
aw-switch-to-window
aw-transpose-frame
aw-update
aw-use-frame
aw-window-list
aw-window<

Defined faces (0)