path: root/devdocs/elisp/frame-titles.html

 <h3 class="section">Frame Titles</h3>  <p>Every frame has a <code>name</code> parameter; this serves as the default for the frame title which window systems typically display at the top of the frame. You can specify a name explicitly by setting the <code>name</code> frame property. </p> <p>Normally you don’t specify the name explicitly, and Emacs computes the frame name automatically based on a template stored in the variable <code>frame-title-format</code>. Emacs recomputes the name each time the frame is redisplayed. </p> <dl> <dt id="frame-title-format">Variable: <strong>frame-title-format</strong>
</dt> <dd><p>This variable specifies how to compute a name for a frame when you have not explicitly specified one. The variable’s value is actually a mode line construct, just like <code>mode-line-format</code>, except that the ‘<samp>%c</samp>’, ‘<samp>%C</samp>’, and ‘<samp>%l</samp>’ constructs are ignored. See <a href="mode-line-data">Mode Line Data</a>. </p></dd>
</dl> <dl> <dt id="icon-title-format">Variable: <strong>icon-title-format</strong>
</dt> <dd><p>This variable specifies how to compute the name for an iconified frame, when you have not explicitly specified the frame title. This title appears in the icon itself. </p></dd>
</dl> <dl> <dt id="multiple-frames">Variable: <strong>multiple-frames</strong>
</dt> <dd>
<p>This variable is set automatically by Emacs. Its value is <code>t</code> when there are two or more frames (not counting minibuffer-only frames or invisible frames). The default value of <code>frame-title-format</code> uses <code>multiple-frames</code> so as to put the buffer name in the frame title only when there is more than one frame. </p> <p>The value of this variable is not guaranteed to be accurate except while processing <code>frame-title-format</code> or <code>icon-title-format</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/Frame-Titles.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Frame-Titles.html</a>
  </p>
</div>