1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
<h3 class="section">Finding All Frames</h3> <dl> <dt id="frame-list">Function: <strong>frame-list</strong>
</dt> <dd><p>This function returns a list of all the live frames, i.e., those that have not been deleted. It is analogous to <code>buffer-list</code> for buffers, and includes frames on all terminals. The list that you get is newly created, so modifying the list doesn’t have any effect on the internals of Emacs. </p></dd>
</dl> <dl> <dt id="visible-frame-list">Function: <strong>visible-frame-list</strong>
</dt> <dd><p>This function returns a list of just the currently visible frames. See <a href="visibility-of-frames">Visibility of Frames</a>. Frames on text terminals always count as visible, even though only the selected one is actually displayed. </p></dd>
</dl> <dl> <dt id="frame-list-z-order">Function: <strong>frame-list-z-order</strong> <em>&optional display</em>
</dt> <dd>
<p>This function returns a list of Emacs’ frames, in Z (stacking) order (see <a href="raising-and-lowering">Raising and Lowering</a>). The optional argument <var>display</var> specifies which display to poll. <var>display</var> should be either a frame or a display name (a string). If omitted or <code>nil</code>, that stands for the selected frame’s display. It returns <code>nil</code> if <var>display</var> contains no Emacs frame. </p> <p>Frames are listed from topmost (first) to bottommost (last). As a special case, if <var>display</var> is non-<code>nil</code> and specifies a live frame, it returns the child frames of that frame in Z (stacking) order. </p> <p>This function is not meaningful on text terminals. </p>
</dd>
</dl> <dl> <dt id="next-frame">Function: <strong>next-frame</strong> <em>&optional frame minibuf</em>
</dt> <dd>
<p>This function lets you cycle conveniently through all the frames on a specific terminal from an arbitrary starting point. It returns the frame following <var>frame</var>, in the list of all live frames, on <var>frame</var>’s terminal. The argument <var>frame</var> must specify a live frame and defaults to the selected frame. It never returns a frame whose <code>no-other-frame</code> parameter (see <a href="frame-interaction-parameters">Frame Interaction Parameters</a>) is non-<code>nil</code>. </p> <p>The second argument, <var>minibuf</var>, says which frames to consider when deciding what the next frame should be: </p> <dl compact> <dt><code>nil</code></dt> <dd><p>Consider all frames except minibuffer-only frames. </p></dd> <dt><code>visible</code></dt> <dd><p>Consider only visible frames. </p></dd> <dt>0</dt> <dd><p>Consider only visible or iconified frames. </p></dd> <dt>a window</dt> <dd><p>Consider only the frames using that particular window as their minibuffer window. </p></dd> <dt>anything else</dt> <dd><p>Consider all frames. </p></dd> </dl> </dd>
</dl> <dl> <dt id="previous-frame">Function: <strong>previous-frame</strong> <em>&optional frame minibuf</em>
</dt> <dd><p>Like <code>next-frame</code>, but cycles through all frames in the opposite direction. </p></dd>
</dl> <p>See also <code>next-window</code> and <code>previous-window</code>, in <a href="cyclic-window-ordering">Cyclic Window Ordering</a>. </p><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/Finding-All-Frames.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Finding-All-Frames.html</a>
</p>
</div>
|
