summaryrefslogtreecommitdiff
path: root/devdocs/elisp/minibuffers-and-frames.html
blob: c3d82a7d639c2eafe2231f13c63adf824ca18150 (plain)
1
2
3
4
5
6
7
8
 <h3 class="section">Minibuffers and Frames</h3> <p>Normally, each frame has its own minibuffer window at the bottom, which is used whenever that frame is selected. You can get that window with the function <code>minibuffer-window</code> (see <a href="minibuffer-windows">Minibuffer Windows</a>). </p>   <p>However, you can also create a frame without a minibuffer. Such a frame must use the minibuffer window of some other frame. That other frame will serve as <em>surrogate minibuffer frame</em> for this frame and cannot be deleted via <code>delete-frame</code> (see <a href="deleting-frames">Deleting Frames</a>) as long as this frame is live. </p> <p>When you create the frame, you can explicitly specify its minibuffer window (in some other frame) with the <code>minibuffer</code> frame parameter (see <a href="buffer-parameters">Buffer Parameters</a>). If you don’t, then the minibuffer is found in the frame which is the value of the variable <code>default-minibuffer-frame</code>. Its value should be a frame that does have a minibuffer. </p> <p>If you use a minibuffer-only frame, you might want that frame to raise when you enter the minibuffer. If so, set the variable <code>minibuffer-auto-raise</code> to <code>t</code>. See <a href="raising-and-lowering">Raising and Lowering</a>. </p> <dl> <dt id="default-minibuffer-frame">Variable: <strong>default-minibuffer-frame</strong>
</dt> <dd><p>This variable specifies the frame to use for the minibuffer window, by default. It does not affect existing frames. It is always local to the current terminal and cannot be buffer-local. See <a href="multiple-terminals">Multiple Terminals</a>. </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/Minibuffers-and-Frames.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Minibuffers-and-Frames.html</a>
  </p>
</div>