diff options
Diffstat (limited to 'devdocs/elisp/forcing-redisplay.html')
| -rw-r--r-- | devdocs/elisp/forcing-redisplay.html | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/devdocs/elisp/forcing-redisplay.html b/devdocs/elisp/forcing-redisplay.html new file mode 100644 index 00000000..c6e14efe --- /dev/null +++ b/devdocs/elisp/forcing-redisplay.html @@ -0,0 +1,18 @@ + <h3 class="section">Forcing Redisplay</h3> <p>Emacs normally tries to redisplay the screen whenever it waits for input. With the following function, you can request an immediate attempt to redisplay, in the middle of Lisp code, without actually waiting for input. </p> <dl> <dt id="redisplay">Function: <strong>redisplay</strong> <em>&optional force</em> +</dt> <dd> +<p>This function tries immediately to redisplay. The optional argument <var>force</var>, if non-<code>nil</code>, forces the redisplay to be performed, instead of being preempted if input is pending. </p> <p>The function returns <code>t</code> if it actually tried to redisplay, and <code>nil</code> otherwise. A value of <code>t</code> does not mean that redisplay proceeded to completion; it could have been preempted by newly arriving input. </p> +</dd> +</dl> <p>Although <code>redisplay</code> tries immediately to redisplay, it does not change how Emacs decides which parts of its frame(s) to redisplay. By contrast, the following function adds certain windows to the pending redisplay work (as if their contents had completely changed), but does not immediately try to perform redisplay. </p> <dl> <dt id="force-window-update">Function: <strong>force-window-update</strong> <em>&optional object</em> +</dt> <dd> +<p>This function forces some or all windows to be updated the next time Emacs does a redisplay. If <var>object</var> is a window, that window is to be updated. If <var>object</var> is a buffer or buffer name, all windows displaying that buffer are to be updated. If <var>object</var> is <code>nil</code> (or omitted), all windows are to be updated. </p> <p>This function does not do a redisplay immediately; Emacs does that as it waits for input, or when the function <code>redisplay</code> is called. </p> +</dd> +</dl> <dl> <dt id="pre-redisplay-function">Variable: <strong>pre-redisplay-function</strong> +</dt> <dd><p>A function run just before redisplay. It is called with one argument, the set of windows to be redisplayed. The set can be <code>nil</code>, meaning only the selected window, or <code>t</code>, meaning all the windows. </p></dd> +</dl> <dl> <dt id="pre-redisplay-functions">Variable: <strong>pre-redisplay-functions</strong> +</dt> <dd><p>This hook is run just before redisplay. It is called once in each window that is about to be redisplayed, with <code>current-buffer</code> set to the buffer displayed in that window. </p></dd> +</dl><div class="_attribution"> + <p class="_attribution-p"> + Copyright © 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/Forcing-Redisplay.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Forcing-Redisplay.html</a> + </p> +</div> |