Next: , Previous: Window Groups, Up: Window Groups


8.17.1 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.

— Function: add-window-to-group window group-id

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.

— Function: add-window-to-new-group window

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.

— Function: window-actual-group-id window

Return the (Sawfish) group ID for window. This is, in order of preference:

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.

— Function: windows-by-group group-id &optional by-depth

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.

— Function: windows-in-group w &optional by-depth

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.

— Function: map-window-group fun w

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.

— Function: map-other-window-groups fun w

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.

— Function: window-group-menu &optional w

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.