Node: Stacking Order, Next: , Previous: Window Stacking, Up: Window Stacking


Stacking Order

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

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

restack-windows list Function
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.

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

window-depth window Function
Returns the depth of window.

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

window-on-top-p window Function
Returns t if window is at the top of its stacking depth.

stack-window-below below above Function
Change stacking order of window below so that it is immediately below window above.

stack-window-above above below Function
Change stacking order of window above so that it is immediately above window below.

save-stacking-order &rest forms Macro
Evaluate forms in an implicit progn, then restore the original window stacking order, returning the value of the progn.

restack-window w Function
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.