Next: , Previous: , Up: Window Groups   [Contents][Index]


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


Next: , Previous: , Up: Window Groups   [Contents][Index]