Assigning Windows to Groups

It is possible to change the group of a window in Sawfish. Use add-window-to-group, or if necessary you can set the window's group property explicitly.

add-window-to-group window group-id

Function

Place window in group group-id, replacing any previous group membership. If group-id is nil, then Sawfish returns the window to whatever group membership was supplied by ICCCM.

add-window-to-new-group window

Function

Place window into a new group, which will have window as its sole member. This is an anonymous user-defined group. The new group ID is returned.

The Sawfish group assignment never overrides the ICCCM group assignment, just suppresses it. The window-actual-group-id function implements this overriding.

window-actual-group-id window

Function

Return the (Sawfish) group ID for window. This is, in order of preference: The group ID assigned by Sawfish The group ID passed in by ICCCM. The corresponding values for an owning window, if the given window is transient. The window's own window ID. This means that a window is, at the very least, part of its own group.

Each of the following functions operates on the "actual group ID" as returned by the above function.

windows-by-group group-id &optional by-depth

Function

Return the list of windows in the group with id group-id. If by-depth is non-nil, then return the windows in order of stacking, from topmost to bottommost.

windows-in-group w &optional by-depth

Function

Return the list of windows in the same group as window w. If by-depth is non-nil, then return the windows in order of stacking, from topmost to bottommost.

map-window-group fun w

Function

Map the single argument function fun over all windows in the same group as window w. Note that fun needs to operate using side-effects, rather than returning values.

map-other-window-groups fun w

Function

Map the single argument function fun over all windows not in the same group as window w. Note that fun needs to operate using side-effects, rather than returning values.

window-group-menu &optional w

Function

Return a menu definition suitable for popup-menu. This menu will allow the user to assign the window w into any group of a managed window, or into a brand new group. The window's current group is checked or otherwise marked.