38.17 Window Configuration Hook

The window-configuration-hook, is a list of functions run whenever the window configuration of a frame changes; such as when a window is deleted, split or resized.

Each function is called with a window as argument, which window depends on what function runs the hook.

When a new frame is created, this hook is not run on the newly created window, please use the create-frame-hook instead, where each function recieves the frame as argument.

There is no guarantee that this will only be run at the end of some function that changes the window configuration (read layout), in fact it can be run several times while the window layout changes.

The core functions that run this hook try to ensure that it does not cause infinite loops, but if you run some functions that change the layout expect trouble.

Here is a complete list of core functions, running the hook. All other window manipulating functions call these and therefore run the hook at some point in time. If not, that’s a bug, and you should report it as such.

delete-window See Deleting Windows.

The window that takes the space of the deleted window is recieved as the argument. If this command deletes the frame, the hook is not run.

delete-other-windows See Deleting Windows.

The window that is left behind is recieved as argument.

set-window-buffer See Buffers and Windows.

The window recievied as argument is passed on to the hook.

split-window See Splitting Windows.

The window recievied as argument is passed on to the hook.

enlarge-window See Resizing Windows.

The window recievied as argument is passed on to the hook.

enlarge-window-pixels See Resizing Windows.

The window recievied as argument is passed on to the hook..

shrink-window See Resizing Windows.

The window recievied as argument is passed on to the hook.

shrink-window-pixels See Resizing Windows.

The window recievied as argument is passed on to the hook.