Previous: , Up: Cycling Between Windows   [Contents][Index]


8.15.2 Dynamic Window Cycles

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

Function: cycle-windows
Function: cycle-windows-backwards

Cycle through all cycleable windows.

Function: cycle-group
Function: cycle-group-backwards

Cycle through all windows inside the same group. This is somewhat comparable to the Control-TAB behavior of Windows OS.

Function: cycle-among-groups
Function: cycle-among-groups-backwards

Cycle through windows at the top of each group.

Function: cycle-prefix
Function: cycle-prefix-backwards

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

Function: cycle-class
Function: cycle-class-backwards

Cycle through all windows whose classes match that of the initial window.

Function: cycle-dock
Function: cycle-dock-backwards

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.

Variable: cycle-include-iconified

If true, Sawfish includes iconified windows when cycling. Defaults to true.

Variable: cycle-all-workspaces

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

Variable: cycle-all-viewports

If true, Sawfish includes windows on all viewports when cycling. Defaults to false.

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

Variable: cycle-show-window-names

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

Variable: cycle-raise-windows t

If true, Sawfish raises windows while they’re temporarily selected during cycling, and invokes warp-pointer-if-necessary. 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.

Function: define-cycle-command name body &rest rest

Create a command that will not cause the current cycle operation to abort before execution.

All arguments are passed to define-command.

Function: define-cycle-command-pair forward-name reverse-name selector &rest rest

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.

Function: window-order #!optional workspace allow-iconified all-viewports

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.

Function: window-order-push w

Push window w onto the top of the cycle stack.

Function: window-order-pop w

Remove window w from the cycle stack.

Function: window-order-most-recent &key windows

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.

Function: window-order-focus-most-recent

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


Previous: , Up: Cycling Between Windows   [Contents][Index]