Next: Choosing Window Options, Previous: Choosing Window, Up: Windows [Contents][Index]
display-bufferにたいするアクション関数以下の基本的なアクション関数がEmacs内で定義されています。これらの関数はそれぞれ表示するバッファーbufferとアクションalistという2つの引数をとります。それぞれのアクション関数は成功したらウィンドウ、失敗したらnilをリターンします。
この関数は選択されたウィンドウ内にbufferの表示を試みる。選択されたウィンドウがミニバッファーウィンドウや他のバッファー専用(Dedicated Windowsを参照)の場合には失敗する。alistに非nilのinhibit-same-windowエントリーがある場合にも失敗する。
この関数は、すでにbufferを表示しているウィンドウを探すことにより、バッファーの“表示”を試みる。
alistに非nilのinhibit-same-windowエントリーがある場合には、選択されたウィンドウは再利用に適さない。alistにreusable-framesエントリーが含まれる場合には、その値により再利用可能なウィンドウをどのフレームで検索するか決定される:
nilは選択されたフレーム(実際には最後の非ミニバッファーフレーム)上のウィンドウを考慮することを意味する。
tはすべてのフレーム上のウィンドウを考慮することを意味する。
visibleはすべての可視フレーム上のウィンドウを考慮することを意味する。
これらはnext-windowにたいするall-frames引数の場合とは若干異なることに注意(Cyclic Window Orderingを参照)。
alistにreusable-framesエントリーが含まれなければ、この関数は通常は選択されたフレームだけを検索する。しかし変数pop-up-framesが非nilならカレント端末上のすべてのフレームを検索する。Choosing Window Optionsを参照。
この関数が他のフレーム上のウィンドウを選択した場合には、そのフレームを可視にするとともに、alistがinhibit-switch-frameエントリー(Choosing Window Optionsを参照)を含んでいなければ必要ならそのフレームを最前面に移動(raise)する。
この関数は新たにフレームを作成して、そのフレームのウィンドウ内にバッファーを表示する。これは実際にはpop-up-frame-function
(Choosing Window Optionsを参照)内で指定された関数を呼び出すことによりフレーム作成の処理を行う。alistがpop-up-frame-parametersエントリーを含む場合には、その連想値(associated
value)が新たに作成されたフレームのパラメーターに追加される。
この関数は、最大のウィンドウ、もしくはもっとも長い間参照されていない(LRU: least
recently-used)ウィンドウを分割することによりbufferの表示を試みる。これは実際にはsplit-window-preferred-function
(Choosing Window Optionsを参照)内で指定された関数を呼び出すことによって分割を行う。
新たなウィンドウのサイズはalistにエントリーwindow-heightとwindow-widthを与えることにより調整できる。ウィンドウの高さを調整するにはCARがwindow-height、CDRが以下のいずれかであるようなエントリーを使用する:
nilは新たなウィンドウの高さを変更しないことを意味する。
shrink-window-if-larger-than-bufferとfit-window-to-buffer。Resizing Windowsを参照のこと。
ウィンドウの幅を調整するにはCARがwindow-width、CDRが以下のいずれかであるようなエントリーを使用する:
nilは新たなウィンドウの幅を変更しないことを意味する。
この関数は何らかの理由により分割を行えるウィンドウが存在しなければ失敗する可能性がある(選択されたフレームがフレームパラメーターunsplittableをもつ場合等。Buffer Parametersを参照)。
この関数は選択されたウィンドウの下のウィンドウ内にbufferの表示を試みる。これは選択されたウィンドウの分割、または選択されたウィンドウの下のウィンドウの使用を意味する。新たにウィンドウを作成した場合には、alistに適切なwindow-heightまたはwindow-widthエントリーが含まれていればサイズの調整も行うだろう。上記を参照のこと。
この関数は以前にbufferを表示していたウィンドウ内にそのバッファーの表示を試みる。alistに非nilのinhibit-same-windowエントリーがある場合には、選択されたウィンドウは再利用に適さない。alistにreusable-framesエントリーが含まれる場合には、display-buffer-reuse-windowと同様に、その値は適正なウィンドウをどのフレームから検索するかを決定する。
alistにprevious-windowエントリーがある場合には、そのエントリーにより指定されたウィンドウは、たとえそのウィンドウが以前にbufferを表示したことが一度もなくても、上記メソッドが見つけた他のすべてのウィンドウをオーバーライドするだろう。
この関数は選択されたフレームの最下にあるウィンドウ内にbufferの表示を試みる。
これはフレーム最下のウィンドウまたはフレームのルートウィンドウを分割するか、選択されたフレーム最下の既存ウィンドウを再利用する。
この関数は既存のウィンドウを選択して、そのウィンドウ内にbufferを表示することによりバッファーの表示を試みる。すべてのウィンドウが他のバッファー専用なら、この関数は失敗する可能性がある(Dedicated Windowsを参照)。
alistに非nilのallow-no-windowエントリーがある場合、この関数はbufferを表示しない。これにより、デフォルトの動作をオーバーライドして、バッファーの表示を避けることができる。これは、呼び出し側がallow-no-windowに非nil値を指定して、display-bufferからリターンされたnil値を処理できるようなケースを想定している。
アクション関数を説明するために以下の例を考えてみましょう。
(display-buffer
(get-buffer-create "*foo*")
'((display-buffer-reuse-window
display-buffer-pop-up-window
display-buffer-pop-up-frame)
(reusable-frames . 0)
(window-height . 10) (window-width . 40)))
上記のフォームを評価することにより、以下のようにdisplay-bufferが実行されます:
(1)*foo*と呼ばれるバッファーがすでに可視またはアイコン化されたフレームに表示されていればそのウィンドウを再利用する。
(2)それ以外なら新たなウィンドウをポップアップ、それが不可能なら新たなフレームでバッファーを表示する。(3)
すべてのステップが失敗すると、それが何であれdisplay-buffer-base-actionとdisplay-buffer-fallback-actionが指示するものを使用して処理を行う。
さらにdisplay-bufferは、(display-bufferにより*foo*が前からそこに配置されていた場合は)再使用されるウィンドウ、およびポップアップされたウィンドウにたいして調整を試みます。そのウィンドウが垂直コンビネーションの一部なら、高さはその行数にセットされるでしょう。数字“10”のかわりに関数fit-window-to-bufferを指定した場合、display-bufferは空のバッファーにフィットするようにウィンドウを1行にセットするでしょう。ウィンドウが水平コンビネーションの一部なら、列数を40にセットします。新たなウィンドウが垂直または水平に組み合わせられるかは、ウィンドウの分割方向とsplit-window-preferred-function、split-height-threshold、split-width-thresholdの値に依存します(Choosing Window Optionsを参照)。
ここで、事前に以下のような‘display-buffer-alist’にたいするセットアップが存在していて、この呼び出しを組み合わせたとしましょう。
(let ((display-buffer-alist
(cons
'("\\*foo\\*"
(display-buffer-reuse-window display-buffer-below-selected)
(reusable-frames)
(window-height . 5))
display-buffer-alist)))
(display-buffer
(get-buffer-create "*foo*")
'((display-buffer-reuse-window
display-buffer-pop-up-window
display-buffer-pop-up-frame)
(reusable-frames . 0)
(window-height . 10) (window-width . 40))))
このフォームはまず選択されたフレーム上で*foo*を表示しているウィンドウを再利用するようにdisplay-bufferに試行させます。そのようなウィンドウが存在しなければ、選択されたウィンドウの分割を試みるか、それが不可能なら選択されたウィンドウの下のウィンドウを使用します。
選択されたウィンドウの下にウィンドウがない、あるいは下のウィンドウがそれのバッファーに専用の場合、display-bufferは前の例で説明したように処理を行うでしょう。しかし、再利用されたウィンドウやポップアップされたウィンドウの高さ調整を試みる場合は、display-bufferのaction引数内の行数に対応する指定をオーバーライドする、行数“5”へのセットを試みることに注意してください。