GNU Emacs 32.0.50 (9008bf64c3) のマニュアルを PLaMo 翻訳で機械翻訳したものです。誤訳を含むことがあります。原文: https://www.gnu.org/software/emacs/manual/html_node/elisp/Finding-All-Frames.html ・ emacs-doc.conao3.com

30.8 すべてのフレームの検索

関数: frame-list

この関数は、すべてのライブフレーム(すなわち、削除されていないフレーム)のリストを返します。これはバッファにおける buffer-list に相当し、ツールチップフレーム(Tooltips を参照)を除くすべてのターミナルのフレームが含まれます。返されるリストは新たに作成されるため、リストを変更しても Emacs の内部構造に影響はありません。

関数: visible-frame-list

この関数は、現在表示されているフレームのみのリストを返します。フレームの表示状態を参照してください。テキスト端末上のフレームは、実際には選択されたもののみが表示されていても、表示されているものとしてカウントされます。

関数: frame-list-z-order &optional display

この関数は、EmacsのフレームをZ(スタッキング)順に並べたリストを返します(フレームの昇降と再スタッキングを参照)。オプション引数 display で、ポーリング対象のディスプレイを指定します。display には、フレーム名またはディスプレイ名(文字列)を指定します。省略した場合、または nil を指定した場合は、選択中のフレームのディスプレイを指します。display にEmacsフレームが含まれていない場合は、nil を返します。

フレームは最上部(最初)から最下部(最後)の順に列挙されます。特殊なケースとして、display が nil ではなく、かつライブフレームを指定している場合、そのフレームの子フレームを Z(スタック順)で返します。

この関数はテキスト端末では意味をなしません。

関数: next-frame &optional frame minibuf

この関数を使用すると、指定したターミナル上のすべてのフレームを、任意の開始点から便利に順に辿ることができます。frameのターミナルにあるすべてのライブフレームのリストにおいて、frameの次のフレームを返します。引数frameにはライブフレームを指定する必要があり、デフォルトでは選択中のフレームが指定されます。no-other-frameパラメータ(フレーム操作パラメータを参照)がnil以外であるフレームは返されません。

第2引数の minibuf は、次のフレームを決定する際にどのフレームを考慮するかを指定します:

nil

ミニバッファのみのフレームを除くすべてのフレームを考慮する。

visible

可視フレームのみを考慮する。

0

可視またはアイコン化されたフレームのみを考慮する。

窓

その特定のウィンドウをミニバッファウィンドウとして使用しているフレームのみを考慮する。

その他

すべてのフレームを考慮する。

この関数が適切なフレームを見つけられない場合、minibuf 引数やその no-other-frame パラメータに照らして条件を満たさない場合であっても、frame を返します。

関数: previous-frame &optional frame minibuf

next-frameと同様だが、すべてのフレームを逆方向に巡回する。

ウィンドウの循環順序のnext-windowおよびprevious-windowも参照してください。

一部のLispプログラムでは、指定された条件を満たすフレームを1つ以上見つける必要があります。この目的のために、関数 filtered-frame-list が用意されています。

関数: filtered-frame-list predicate

この関数は、指定された predicate を満たすすべてのライブフレームのリストを返します。引数 predicate は、フィルタリング基準に照らして判定するフレームという1つの引数を取る関数である必要があり、フレームが基準を満たす場合は non-nil を返す必要があります。