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, instead iconified windows are shown slightly differently in the menu of all windows.

iconify-window window

Command

Iconify the window associated with object window.

uniconify-window window

Command

Return the window associated with window from its iconified state.

toggle-window-iconified window

Command

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

iconify-workspace-windows

Command

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:

window-iconified-p window

Function

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

window-iconifiable-p window

Function

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.

iconify-ignored nil

Variable

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

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

focus-windows-on-uniconify

Variable

Windows are focused after being unminimized. Defaults to false.

raise-windows-on-uniconify

Variable

Windows are raised after being unminimized. Defaults to true.

uniconify-to-current-workspace

Variable

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

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

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

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.

none

No additional windows are minimized or restored.

transients

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

group

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.

window-icon-image window

Function

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