Go to the previous, next section.

Screen Size

The screen size functions report or tell Emacs the height or width of the terminal. When you are using multiple frames, they apply to the selected frame (see section Frames).

Function: screen-height

This function returns the number of lines on the screen that are available for display.

(screen-height)
     => 50

Function: screen-width

This function returns the number of columns on the screen that are available for display.

(screen-width)
     => 80

Function: set-screen-height lines &optional not-actual-size

This function declares that the terminal can display lines lines. The sizes of existing windows are altered proportionally to fit.

If not-actual-size is non-nil, then Emacs displays lines lines of output, but does not change its value for the actual height of the screen. (Knowing the correct actual size may be necessary for correct cursor positioning.) Using a smaller height than the terminal actually implements may be useful to reproduce behavior observed on a smaller screen, or if the terminal malfunctions when using its whole screen.

If lines is different from what it was previously, then the entire screen is cleared and redisplayed using the new size.

This function returns nil.

Function: set-screen-width columns &optional not-actual-size

This function declares that the terminal can display columns columns. The details are as in set-screen-height.

Go to the previous, next section.