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


8.9.1 Stacking Order

Function: stacking-order

Return a list of window objects defining the current stacking order of all client windows, from top-most to bottom-most.

Function: mapped-stacking-order

Similar to stacking-order, but only returns windows that are mapped.

Function: restack-windows list

Restack all client windows specified in the list of window objects list in the order they occur in the list (from top to bottom). The stacking order of any unspecified windows isn’t affected.

Sawfish allows the stacking order to be managed as a sequence of layers, with windows being assigned a particular depth within the order. For any given window with depth d, it will be above all windows with depth less than d, and below all windows with depth greater than d. It may be above or below any other windows with depth d.

The depth property of each window is used to store this depth. A depth of zero is “normal”, with negative depths stacked below, and positive depths stacked above this normal level.

Function: stacking-order-by-depth depth

Similar to stacking-order, but only returns windows with depth depth.

Function: window-depth window

Returns the depth of window.

Function: set-window-depth window depth

Sets the stacking depth of window to depth, then restacks the windows to reflect this change.

Functions to change stacking order.

Function: window-on-top-p window

Returns t if window is at the top of its stacking depth.

Function: stack-window-below below above

Change stacking order of window below so that it is immediately below window above. This function alone does not raise / lower windows.

Function: stack-window-above above below

Change stacking order of window above so that it is immediately above window below. This function alone does not raise / lower windows.

Macro: save-stacking-order &rest forms

Evaluate forms in an implicit progn, then restore the original window stacking order, returning the value of the progn.

Function: restack-window w

Assuming that the current stacking order is in a consistent state except, possibly, for the position of window w, restore the consistent state including window w. This is achieved by raising or lowering window W as appropriate.


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