Keymaps

Keymaps are used to associate events with commands. When an event occurs, the associated command is found and evaluated. A keymap is simply a list whose first element is the symbol keymap.

keymapp arg

Function

Returns t if arg may be used as a keymap.

make-keymap

Function

Returns a newly-created empty keymap.

bind-keys keymap &rest bindings

Function

Installs zero or more key bindings into the keymap keymap, then returns keymap. Each binding is defined by two elements in the list of bindings, the first defines the name of the input event (or the event itself) and the second defines the command to be associated with the event. For example to bind two keys in the keymap keymap; the event C-f to the command foo and the event C-b to the command bar the following form would be used, (bind-keys keymap "C-f" 'foo "C-b" 'bar)

unbind-keys keymap &rest keys

Function

Removes the bindings of the events keys (these may be the names of the events or the event objects themselves) from the keymap keymap.

search-keymap event keymap

Function

Search for a binding of the event event in keymap. If a binding is found a cons cell (command . event) is returned.

There are several pre-defined keymaps that are always available:

global-keymap

Keymap containing bindings active anywhere.

window-keymap

Keymap containing bindings active when a client window is focused.

root-window-keymap

Keymap containing bindings active when the pointer is in the root window.

title-keymap

border-keymap

Keymaps active in the title and borders of window frames.

close-button-keymap

iconify-button-keymap

maximize-button-keymap

menu-button-keymap

shade-button-keymap

Keymaps active in the standard window frame buttons.

override-keymap

Must be a keymap, a symbol, or nil. If it is a keymap, this becomes the keymap in which all lookups occur (overriding the window, root and global keymaps). If it is a symbol, Sawfish finds the symbol's value and tries again. If it is nil, Sawfish behaves normally.