Node: Dynamic Window Cycles, Previous: Fixed Window Cycles, Up: Cycling Between Windows



Dynamic Window Cycles

These commands implement something much close to Microsoft Windows' <Alt-TAB> mechanism, working with a stack of recently used windows.

cycle-windows Function
cycle-windows-backwards Function
Cycle through all cycleable windows.

cycle-group Function
cycle-group-backwards Function
Cycle through all windows in this group.

This is somewhat comparable to the <Control-TAB> behavior of windows.

cycle-prefix Function
cycle-prefix-backwards Function
Cycle through all windows whose titles match that of the initial window (up to, but not including, the first colon).

cycle-class Function
cycle-class-backwards Function
Cycle through all windows whose classes match that of the initial window.

cycle-dock Function
cycle-dock-backwards Function
Cycle through all windows in the dock, even those with the cycle-skip property.

Each of these cycling commands may include windows that are not visible on-screen.

cycle-include-iconified Variable
If true, Sawfish includes iconified windows when cycling. Defaults to true.

cycle-all-workspaces Variable
If true, Sawfish includes windows on all workspaces when cycling. Defaults to false.

It is possible to configure the cycling to get more feedback during the process.

cycle-show-window-names Variable
If true, Sawfish displays window names and icons while cycling through windows. Defaults to true.

cycle-raise-windows t Variable
If true, Sawfish raises windows while they're temporarily selected during cycling. Defaults to true.

It is also possible for you to define your own stacking cycle commands, or even to alter the window stack to suit your tastes.

define-cycle-command name body &rest rest Function
Create a command that will not cause the current cycle operation to abort before execution.

All arguments are passed to define-command.

define-cycle-command-pair forward-name reverse-name selector &rest rest Function
Create a pair of commands for cycling through windows. The command named forward-name cycles forwards, while the command named reverse-name cycles backwards.

Selector is called when initializing the cycle environment, it should return the list of windows to cycle through, or the symbol `t' to denote all cyclable windows.

Any extra arguments are passed to each call to define-command.

window-order &optional workspace allow-iconified all-viewports Function
Return managed windows in most-recently used order.

If workspace is non-nil, then only managed windows in that workspace will be returned.

If allow-iconified is non-nil, then iconified windows will be returned instead of ignored.

If all-viewports is non-nil, then windows in all viewports will be returned, instead of just the current viewport.

window-order-push w Function
Push window w onto the top of the cycle stack.

window-order-pop w Function
Remove window w from the cycle stack.

window-order-most-recent &key windows Function
Return the most-recently focused window in the current workspace. If the windows argument is given it should be a list of windows, in this case the function will restrict its search to the elements of this list.

window-order-focus-most-recent Function
Switch input focus to the most-recently focused window in the current workspace.