devdocs/elisp/refresh-screen.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14

 <h3 class="section">Refreshing the Screen</h3>   <p>The function <code>redraw-frame</code> clears and redisplays the entire contents of a given frame (see <a href="frames">Frames</a>). This is useful if the screen is corrupted. </p> <dl> <dt id="redraw-frame">Function: <strong>redraw-frame</strong> <em>&amp;optional frame</em>
</dt> <dd><p>This function clears and redisplays frame <var>frame</var>. If <var>frame</var> is omitted or <code>nil</code>, it redraws the selected frame. </p></dd>
</dl> <p>Even more powerful is <code>redraw-display</code>: </p> <dl> <dt id="redraw-display">Command: <strong>redraw-display</strong>
</dt> <dd><p>This function clears and redisplays all visible frames. </p></dd>
</dl> <p>In Emacs, processing user input takes priority over redisplay. If you call these functions when input is available, they don’t redisplay immediately, but the requested redisplay does happen eventually—after all the input has been processed. </p> <p>On text terminals, suspending and resuming Emacs normally also refreshes the screen. Some terminal emulators record separate contents for display-oriented programs such as Emacs and for ordinary sequential display. If you are using such a terminal, you might want to inhibit the redisplay on resumption. </p> <dl> <dt id="no-redraw-on-reenter">User Option: <strong>no-redraw-on-reenter</strong>
</dt> <dd>
  <p>This variable controls whether Emacs redraws the entire screen after it has been suspended and resumed. Non-<code>nil</code> means there is no need to redraw, <code>nil</code> means redrawing is needed. The default is <code>nil</code>. </p>
</dd>
</dl><div class="_attribution">
  <p class="_attribution-p">
    Copyright &copy; 1990-1996, 1998-2022 Free Software Foundation, Inc. <br>Licensed under the GNU GPL license.<br>
    <a href="https://www.gnu.org/software/emacs/manual/html_node/elisp/Refresh-Screen.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Refresh-Screen.html</a>
  </p>
</div>