Frame Types

In order to visually differentiate between different types of windows, several predefined types of window frame exist.

window-type window

Function

Returns a symbol naming the frame type currently associated with window.

These frame types currently include the following:

default

The normal frame type. Includes all decorations, both borders and the title bar.

transient

The frame for a transient window. This usually does not include a title bar, but does have all four borders.

shaped

Shaped windows are normally decorated with only a title-bar, since their boundary is not rectangular it makes no sense to surround them with a rectangular border.

shaped-transient

A combination of the shaped and transient types, normally just a very small title border with no text.

shaded

A shaded window (normally just the title bar).

shaded-transient

A shaded transient window.

unframed

No frame at all, just the client window itself. The predefined nil-frame variable contains a null frame that may be used for this frame type.

define-frame-type-mapper fun

Function

Function fun maps from {window, frame-type} to frame-type. Each time we want to determine a window's frame-type (shaded, transient, etc.), we calculate an initial frame type with window-type and run the results through each frame type mapper in sequence (most recent to oldest). The frame type returned from the final mapper function is "the" frame type. This sequence of mappers allows us to override window frame types based on window properties. For example, any shaded window has to have shaded or shaded-transient type, regardless of what its normal type is.

window-type-add-border type	Function
window-type-add-title type	Function
window-type-remove-border type	Function
window-type-remove-title type	Function

Given a window type of type, return the closest matching window type with the given property change. For example: (window-type-add-title 'unframed) => 'shaped This is because shaped windows normally have title bars but not borders, while unframed windows normally have neither.

frame-type-menu window

Function

Returns a list of frame types, suitable for use by the graphical customizer. The frame type of window is automatically checked.

We provide a function to simplify monitoring of window changes to certain window states. This monitoring runs on top of the window-state-change-hook.

call-after-state-changed states fun

Function

Arrange for function fun to be called with arguments (window changed-states) when one of the states defined by the list of symbols states has been changed. States may also be a single symbol.