Next: , Previous: , Up: Windows   [Contents][Index]

8.18 Iconifying Windows

X defines an iconic state for windows, often windows in this state are displayed as small icons. Sawfish does not display these icons. Use softwares called “trayers” and / or “pagers” for such things.

Function: iconify-window window
Command: iconify-window window

Iconify the window associated with object window.

Function: uniconify-window window
Command: uniconify-window window

Return the window associated with window from its iconified state.

Function: toggle-window-iconified window
Command: toggle-window-iconified window

Minimize the window associated with window, or restore it if it is already minimized.

Function: iconify-workspace-windows
Command: iconify-workspace-windows

Minimize all windows in the current workspace.

A window’s iconic state may be tested through examination of its iconified property—when t the window is iconified. But it is preferable to use explicit testing functions instead:

Function: window-iconified-p window

Returns true if the window associated with window is iconified, false otherwise.

Function: window-iconifiable-p window

Returns true if the window associated with window can be iconified, false otherwise. Some reasons a window might not be iconifiable are: it has a never-iconify property; it is already iconified; it is not a desktop window; or it is marked ignored and iconify-ignored is not true.

Variable: iconify-ignored nil

Unmanaged (ignored) windows may be iconified. Defaults to nil.

Sawfish allows you to control certain behaviors when restoring minimized windows.

Variable: focus-windows-on-uniconify

Windows are focused after being unminimized. Defaults to false.

Variable: raise-windows-on-uniconify

Windows are raised after being unminimized. Defaults to true.

Variable: uniconify-to-current-workspace

Move windows to the current workspace when they are unminimized. Defaults to true.

When iconifying, it is possible to force other windows to iconify.

Customizable: iconify-group-mode
Customizable: uniconify-group-mode

Policy for performing chains of minimizations or restorations. When a particular window is minimized or restored, it can cause other windows to be minimized or restored at the same time. Their allowed values are set to the following list. By default, both variables are bound to the symbol transients. but they are not required to have the same value.


No additional windows are minimized or restored.


All transient windows associated with the target window are minimized or restored.


All windows in the target window’s group are minimized or restored.

Finally, it’s possible to get the icon that would normally be displayed for an iconified window.

Function: window-icon-image window

Return an image object representing the icon currently associated with window, or nil if there is no such image.

Function: window-icon-name window

Return the icon name associated with window.

When a window has a property iconify-on-leave set to non-nil, it gets iconified when the mouse pointer leaves it. It can be set from the configurator.

;; Example:
;; ( add-window-matcher '( ( WM_CLASS . "^Konsole/konsole$" ) )
;;   '( ( iconify-on-leave . t ) ) )

Next: , Previous: , Up: Windows   [Contents][Index]