Next: Choosing Window Options, Previous: Buffer Display Action Functions, Up: Displaying Buffers [Contents][Index]
アクションalist(action
alist)とはアクション関数が認識可能な事前定義されたシンボルと、それに応じてそれらの関数が解釈することを意図した値をマップする連想リストです。各呼び出しにおいてdisplay-buffer
は新たなアクションalist(空の場合もある)を作成して、呼び出すすべてのアクション関数にそのリスト全体を渡します。
仕様によりアクション関数はアクションalist全体を自由に解釈できます。実際のところallow-no-window
やprevious-window
のようないくつかのエントリーはいくつかのアクション関数によってのみ意味があり、他のアクション関数では無視されます。それ以外のinhibit-same-window
やwindow-parameters
のようなエントリーは、アプシケーションプログラムや外部パッケージから提供されるものも含めて、ほとんどのアクション関数がしたがいます。
前のサブセクションでは、個別のアクション関数がアクションエントリーを処理する方法の詳細を説明しました。ここでは既知のアクションalistエントリーに対応するすべてのシンボル、およびそれらの値とそれらを認識するアクション関数(Buffer Display Action Functionsを参照)とともに示すリファレンスリストを提供します。このリストにおいて用語“バッファー”はdisplay-buffer
が表示しようとするバッファー、“値”はそのエントリーの値を意味しています。
inhibit-same-window
値が非nil
なら、バッファーの表示に選択されたウィンドウを使用してはならないことを告げる。既存のウィンドウを(再)使用するすべてのアクション関数は、このエントリーにしたがう必要がある。
previous-window
値には以前にバッファーを表示した可能性のあるウィンドウを指定しなければならない。そのようなウィンドウがまだ生きていて他のバッファー専用でなれば、display-buffer-in-previous-window
はそのウィンドウを優先する。
mode
値はメジャーモードかメジャーモードのリスト。このエントリーが指定する値がウィンドウのバッファーのメジャーモードにマッチすれば、display-buffer-reuse-mode-window
は常にそのウィンドウを再利用する。これ以外のアクション関数はこのエントリーを無視する。
frame-predicate
値はのそのフレームがバッファーを表示する候補なら非nil
をリターンする単一の引数(フレーム)を受け取る関数でなければならない。このエントリーはdisplay-buffer-use-some-frame
が使用する。
reusable-frames
値はバッファーをすでに表示していたことにより再利用可能なウィンドウを検索するためのフレームセットを指定する。以下をセット可能:
nil
は選択されたフレーム(実際にはミニバッファーフレーム以外の最後に使用されたフレーム)上のウィンドウだけを考慮することを意味する。
t
はすべてのフレーム上のウィンドウを考慮することを意味する。
visible
はすべての可視フレーム上のウィンドウを考慮することを意味する。
nil
の意味はnext-window
にたいするall-frames引数の場合の意味とは若干異なることに注意(Cyclic Window Orderingを参照)。
これの主要クライアントはdisplay-buffer-reuse-window
だが、ウィンドウの再利用を試みる他のすべてのアクション関数も同様に影響を受ける。display-buffer-in-previous-window
はバッファーを以前に表示していたウィンドウを別フレーム上で検索する際にこれを参照する。
inhibit-switch-frame
非nil
値の場合には、display-buffer
により選択されたウィンドウがすでに表示されていれば別のフレームのraiseや選択を抑制する。これにより主に影響を受けるのはdisplay-buffer-use-some-frame
とdisplay-buffer-reuse-window
。同様にdisplay-buffer-pop-up-frame
も影響を受けるべきだが、ウィンドウマネージャーがこれに準拠する保証はない。
window-parameters
値は選択したウィンドウに与えるウィンドウパラメーターのalist。ウィンドウを選択するすべてのアクション関数は、このエントリーを処理する必要がある。
window-min-height
値は使用するウィンドウの最小高さを行数で指定する。ウィンドウの高さがこのエントリーで指定した高さではない、あるいはできなければウィンドウの使用を考慮しない。このエントリーのクライアントは現在のところdisplay-buffer-below-selected
のみ。
このようなエントリーを単独で提供しても、ウィンドウがその値で指定した高さになるとは限らないことに注意。既存ウィンドウを実際にリサイズしたり新たなウィンドウの高さを指定した値にするためには、同様にこの値を指定するwindow-height
エントリーを提供する必要がある。しかしこのようなwindow-height
エントリーでまったく異なる値を指定したり、ウィンドウ高さをバッファーにフィットするように要請することができる。そのような場合にはwindow-min-height
使用するウィンドウの最小高さにたいする保証を与える。
window-height
値は選択したウィンドウの高さを調節するかとその方法を指定する。以下のいずれか:
nil
は選択したウィンドウの高さを変更しないことを意味する。
shrink-window-if-larger-than-buffer
とfit-window-to-buffer
。Resizing Windowsを参照のこと。
慣例により選択したウィンドウの高さは、そのウィンドウが垂直コンビネーション(Windows and Framesを参照)の一部であり、他の無関係のウィンドウの高さの変更を避ける場合のみ調整される。さらにこのエントリーはこのリストの後に指定する特定の条件下でのみ処理される必要がある。
window-width
これは上述のwindow-height
と同様だが、かわりに選択したウィンドウの幅の調節に使用される。値は以下のいずれか:
nil
は選択したウィンドウの幅を変更しないことを意味する。
慣例により選択したウィンドウの幅は、そのウィンドウが水平コンビネーション(Windows and Framesを参照)の一部であり、他の無関係のウィンドウの幅の変更を避ける場合のみ調整される。さらにこのエントリーはこのリストの後に指定する特定の条件下でのみ処理される必要がある。
dedicated
このようなエントリーが非nil
なら、display-buffer
は作成するすべてのウィンドウをそのバッファー専用であるとマークする(Dedicated Windowsを参照)。これは最初の引数に選択したウィンドウ、2つ目の引数にエントリーの値を指定してset-window-dedicated-p
を呼び出すことにより行われる。
preserve-size
このようなエントリーが非nil
なら、選択したウィンドウのサイズを維持するようにEmacsに指示する(Preserving Window Sizesを参照)。値は(t . nil)
(ウィンドウの幅を維持)、(nil . t)
(高さを維持)、または(t . t)
(幅と高さの両方を維持)のいずれか。このエントリーはこのリストの後に指定する特定の条件下でのみ処理される必要がある。
pop-up-frame-parameters
この値は新たにフレームが作成された場合に与えるフレームパラメーターのalist。display-buffer-pop-up-frame
がけが参照する。
parent-frame
値は子フレームにバッファーを表示時に使用する親フレームを指定する。このエントリーを使用するのはdisplay-buffer-in-child-frame
のみ。
child-frame-parameters
値は子フレームにバッファー表示時に使用するフレームパラメーターのalistを指定する。このエントリーを使用するのはdisplay-buffer-in-child-frame
のみ。
side
値はバッファーを表示する新たなウィンドウを、フレームやバッファーのどのサイドに作成するかを示す。このエントリーは新たなサイドウィンドウをフレームのどのサイドに配置するかを示すためにdisplay-buffer-in-side-window
が使用する(Displaying Buffers in Side Windowsを参照)。さらに新たなサイドウィンドウを既存ウィンドウのどのサイドに配置するかを示すためにdisplay-buffer-in-atom-window
にも使用される(Atomic Windowsを参照)。
slot
値が非nil
ならバッファーを表示するサイドウィンドウのスロットを指定する。このエントリーを使用するのはdisplay-buffer-in-side-window
のみ。
direction
この値はwindow
エントリーとともに、display-buffer-in-direction
がバッファーを表示するウィンドウ位置を決定するための方向を指定する。
window
値はdisplay-buffer
で選択されたウィンドウと何らかの関連があるウィンドウを指定する。このエントリーは現在のところ新たなウィンドウが作成されるサイドのウィンドウを示すためにdisplay-buffer-in-atom-window
が使用する。これは結果のウィンドウが出現する側の参照ウィンドウを指定するためにdisplay-buffer-in-direction
も使用する。
allow-no-window
値が非nil
ならdisplay-buffer
は必ずしもバッファーを表示する必要はなく、呼び出し側はそれを受け入れる準備がある。display-buffer
の任意の呼び出し手がバッファーを表示するウィンドウが存在しないケースを処理できる保証がないので、、このエントリーはユーザーのカスタマイゼーションを意図したものではない。このエントリーを考慮するアクション関数はdisplay-buffer-no-window
のみ。
慣例によりエントリーwindow-height
、window-width
、preserve-size
は選択したウィンドウのバッファーのセットアップ後、かつそのウィンドウが以前に他のバッファーを表示していない場合のみ適用されます。後者はより正確にはカレントのdisplay-buffer
呼び出しによりウィンドウが作成されたか、以前にそのバッファーを表示するためにdisplay-buffer
によりウィンドウが作成されて、カレントのdisplay-buffer
呼び出しによる再利用まで他のバッファーの表示に使用されたことがないことを意味します。