— Window Hook: enter-notify-hook
— Window Hook: enter-frame-part-hook

Called when the pointer enters a window (including the root window).

If the window was part of a frame, then enter-frame-part-hook is called with three arguments: the window, the frame part class (see Frame Part Classes), and focus-mode.

Otherwise enter-notify-hook is called with two arguments: the window and focus-mode.

The root window is considered to be a valid window for this hook. Sawfish will report entering the root window.

— Window Hook: leave-notify-hook
— Window Hook: leave-frame-part-hook

Called when the pointer leaves a window (including the root window).

If the window was part of a frame, then leave-frame-part-hook is called with three arguments: the window, the frame part class (see Frame Part Classes), and focus-mode.

Otherwise leave-notify-hook is called with two arguments: the window and focus-mode.

The root window is considered to be a valid window for this hook. Sawfish will report leaving the root window.

— Window Hook: focus-in-hook

Called when focus gains focus. The hook functions take two arguments: the window that received focus, and focus-mode.

If your focus-mode is set to enter-exit, your window focus is tightly bound to your pointer position; focus-related hooks and enter/leave hooks will be called in lockstep. For other values of focus-mode, Sawfish will trigger fewer focus-related hook calls than enter/leave hook calls.

This hook is never called for the root window, because the root window never gets focus.

— Window Hook: focus-out-hook

Called when a window loses focus. The hook functions take two arguments: the window that lost focus, and focus-mode.

If your focus-mode is set to enter-exit, your window focus is tightly bound to your pointer position; focus-related hooks and enter/leave hooks will be called in lockstep. For other values of focus-mode, Sawfish will trigger fewer focus-related hook calls than enter/leave hook calls.

This hook is never called for the root window, because the root window never gets focus.