summaryrefslogtreecommitdiff
path: root/devdocs/elisp/frame-parameters.html
blob: ee92c2ee215e97fcb20cbda7b50819c74ac0eb0a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
 <h3 class="section">Frame Parameters</h3>  <p>A frame has many parameters that control its appearance and behavior. Just what parameters a frame has depends on what display mechanism it uses. </p> <p>Frame parameters exist mostly for the sake of graphical displays. Most frame parameters have no effect when applied to a frame on a text terminal; only the <code>height</code>, <code>width</code>, <code>name</code>, <code>title</code>, <code>menu-bar-lines</code>, <code>buffer-list</code> and <code>buffer-predicate</code> parameters do something special. If the terminal supports colors, the parameters <code>foreground-color</code>, <code>background-color</code>, <code>background-mode</code> and <code>display-type</code> are also meaningful. If the terminal supports frame transparency, the parameter <code>alpha</code> is also meaningful. </p> <p>By default, frame parameters are saved and restored by the desktop library functions (see <a href="desktop-save-mode">Desktop Save Mode</a>) when the variable <code>desktop-restore-frames</code> is non-<code>nil</code>. It’s the responsibility of applications that their parameters are included in <code>frameset-persistent-filter-alist</code> to avoid that they get meaningless or even harmful values in restored sessions. </p> <table class="menu" border="0" cellspacing="0"> <tr>
<td align="left" valign="top">• <a href="parameter-access" accesskey="1">Parameter Access</a>
</td>
<td> </td>
<td align="left" valign="top">How to change a frame’s parameters. </td>
</tr> <tr>
<td align="left" valign="top">• <a href="initial-parameters" accesskey="2">Initial Parameters</a>
</td>
<td> </td>
<td align="left" valign="top">Specifying frame parameters when you make a frame. </td>
</tr> <tr>
<td align="left" valign="top">• <a href="window-frame-parameters" accesskey="3">Window Frame Parameters</a>
</td>
<td> </td>
<td align="left" valign="top">List of frame parameters for window systems. </td>
</tr> <tr>
<td align="left" valign="top">• <a href="geometry" accesskey="4">Geometry</a>
</td>
<td> </td>
<td align="left" valign="top">Parsing geometry specifications. </td>
</tr> </table><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-Parameters.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Frame-Parameters.html</a>
  </p>
</div>