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


8.4 Window Types

Some window “types” are defined. They represent the window’s special nature based on the role. Defined types are “transient”, “desktop”, and “dock”.

A type is usually set by applications through hints when the window appears. Many windows do not have any types.

“Transient” windows are pop-up or dialog windows associated with a main application. They tend to have less window decorations, and are intended to last a short time only.

Function: window-transient-p window

Returns nil if window isn’t marked as a transient window. Otherwise returns an integer, the xid of the parent window.

Function: mark-window-as-transient w

Mark that the window associated with object w is a transient window.

Function: transient-of-p child parent

Return true if window child is directly a transient for window parent, false otherwise.

Function: indirect-transient-of-p descendant ancestor

Return true if window descendant is (directly or indirectly) a transient for window ancestor, false otherwise.

Function: transient-parents child #!optional indirectly

Return the list of windows that window child is a transient for. If indirectly is true, then return the list of all ancestors rather than parents.

Function: transient-children parent #!optional indirectly

Return the list of windows that are transients for window parent. If indirectly is true, then return the list of all descendants rather than children.

Function: transient-group window #!optional by-depth

Return the list of windows which is either a transient window for window window, or a window which window is a transient for. This always includes W. The ‘transient window for’ relation holds for windows which are direct or indirect transients of the parent window in question.

If the by-depth argument is true, then the retrurned list is in stacking order.

Function: map-transient-group fun window

Map the single argument function fun over all windows in the same transient group as window window.

Function: raise-window-and-transients window

Raise window window to its highest allowed position in the stacking order. Also raise any transient windows that it has.

Function: lower-window-and-transients window

Lower window window to its lowest allowed position in the stacking order. Also lower any transient windows that it has.

Function: raise-lower-window-and-transients window

If window window is at its highest possible position, then lower it to its lowest possible position. Otherwise raise it as far as allowed. Also changes the level of any transient windows it has.

Customizable: focus-windows-when-mapped

Focus on application windows when they first appear. Defaults to true, must be true or false.

Variable: decorate-transients

Decorate dialog windows similarly to application windows. Defaults to false.

“Desktop” windows are root windows or viewport windows. They accept keys as if it is a root window. (I.e., root-window-keymap is used.) They don’t have a frame.

Function: desktop-window-p arg

Returns t if arg represents a desktop window.

Function: mark-window-as-desktop w

Mark that the window associated with object w is a desktop window.

Variable: desktop-window-properties

List of properties set (to true) on windows when they are marked as desktops. Defaults to

'(fixed-position sticky sticky-viewport)
Variable: desktop-window-depth

The stacking depth of desktop windows. Defaults to -4.

“Dock” windows are docks or panels. They don’t have frame by default.

Function: dock-window-p arg

Returns t if arg represents a dock window.

Function: mark-window-as-dock w

Mark that the window associated with object w is a dock window.

Variable: dock-window-properties

List of properties set (to true) on windows when they are marked as docks. Defaults to

'(window-list-skip cycle-skip fixed-position focus-click-through
  avoid no-history never-iconify never-maximize sticky
  sticky-viewport placed)
Variable: dock-window-depth

The stacking depth of dock windows. Defaults to 0.


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