Function: window-height

window-height is a function alias for window-total-height, defined in window.c.

Signature

(window-height &optional WINDOW ROUND)

Documentation

Return the height of window WINDOW in lines.

WINDOW must be a valid window and defaults to the selected one.

The return value includes the heights of WINDOW's mode and header line and its bottom divider, if any. If WINDOW is an internal window, the total height is the height of the screen areas spanned by its children.

If WINDOW's pixel height is not an integral multiple of its frame's character height, the number of lines occupied by WINDOW is rounded internally. This is done in a way such that, if WINDOW is a parent window, the sum of the total heights of all its children internally equals the total height of WINDOW.

If the optional argument ROUND is ceiling, return the smallest integer larger than WINDOW's pixel height divided by the character height of WINDOW's frame. ROUND floor means to return the largest integer smaller than WINDOW's pixel height divided by the character height of WINDOW's frame. Any other value of ROUND means to return the internal total height of WINDOW.

Probably introduced at or before Emacs version 22.1.

Aliases

reftex-window-height (obsolete since 30.1) window-height