Next: , Previous: , Up: Windows   [Contents][Index]


27.13 display-bufferにたいするアクション関数

以下の基本的なアクション関数がEmacs内で定義されています。これらの関数はそれぞれ表示するバッファーbufferとアクションalistという2つの引数をとります。それぞれのアクション関数は成功したらウィンドウ、失敗したらnilをリターンします。

Function: display-buffer-same-window buffer alist

この関数は選択されたウィンドウ内にbufferの表示を試みる。選択されたウィンドウがミニバッファーウィンドウや他のバッファー専用(Dedicated Windowsを参照)の場合には失敗する。alistに非nilinhibit-same-windowエントリーがある場合にも失敗する。

Function: display-buffer-reuse-window buffer alist

この関数は、すでにbufferを表示しているウィンドウを探すことにより、バッファーの“表示”を試みる。

alistに非nilinhibit-same-windowエントリーがある場合には、選択されたウィンドウは再利用に適さない。alistreusable-framesエントリーが含まれる場合には、その値により再利用可能なウィンドウをどのフレームで検索するか決定される:

これらはnext-windowにたいするall-frames引数の場合とは若干異なることに注意(Cyclic Window Orderingを参照)。

alistreusable-framesエントリーが含まれなければ、この関数は通常は選択されたフレームだけを検索する。しかし変数pop-up-framesが非nilならカレント端末上のすべてのフレームを検索する。Choosing Window Optionsを参照。

この関数が他のフレーム上のウィンドウを選択した場合には、そのフレームを可視にするとともに、alistinhibit-switch-frameエントリー(Choosing Window Optionsを参照)を含んでいなければ必要ならそのフレームを最前面に移動(raise)する。

Function: display-buffer-pop-up-frame buffer alist

この関数は新たにフレームを作成して、そのフレームのウィンドウ内にバッファーを表示する。これは実際にはpop-up-frame-function (Choosing Window Optionsを参照)内で指定された関数を呼び出すことによりフレーム作成の処理を行う。alistpop-up-frame-parametersエントリーを含む場合には、その連想値(associated value)が新たに作成されたフレームのパラメーターに追加される。

Function: display-buffer-pop-up-window buffer alist

この関数は、最大のウィンドウ、もしくはもっとも長い間参照されていない(LRU: least recently-used)ウィンドウを分割することによりbufferの表示を試みる。これは実際にはsplit-window-preferred-function (Choosing Window Optionsを参照)内で指定された関数を呼び出すことによって分割を行う。

新たなウィンドウのサイズはalistにエントリーwindow-heightwindow-widthを与えることにより調整できる。ウィンドウの高さを調整するにはCARwindow-heightCDRが以下のいずれかであるようなエントリーを使用する:

ウィンドウの幅を調整するにはCARwindow-widthCDRが以下のいずれかであるようなエントリーを使用する:

この関数は何らかの理由により分割を行えるウィンドウが存在しなければ失敗する可能性がある(選択されたフレームがフレームパラメーターunsplittableをもつ場合等。Buffer Parametersを参照)。

Function: display-buffer-below-selected buffer alist

この関数は選択されたウィンドウの下のウィンドウ内にbufferの表示を試みる。これは選択されたウィンドウの分割、または選択されたウィンドウの下のウィンドウの使用を意味する。新たにウィンドウを作成した場合には、alistに適切なwindow-heightまたはwindow-widthエントリーが含まれていればサイズの調整も行うだろう。上記を参照のこと。

Function: display-buffer-in-previous-window buffer alist

この関数は以前にbufferを表示していたウィンドウ内にそのバッファーの表示を試みる。alistに非nilinhibit-same-windowエントリーがある場合には、選択されたウィンドウは再利用に適さない。alistreusable-framesエントリーが含まれる場合には、display-buffer-reuse-windowと同様に、その値は適正なウィンドウをどのフレームから検索するかを決定する。

alistprevious-windowエントリーがある場合には、そのエントリーにより指定されたウィンドウは、たとえそのウィンドウが以前にbufferを表示したことが一度もなくても、上記メソッドが見つけた他のすべてのウィンドウをオーバーライドするだろう。

Function: display-buffer-at-bottom buffer alist

この関数は選択されたフレームの最下にあるウィンドウ内にbufferの表示を試みる。

これはフレーム最下のウィンドウまたはフレームのルートウィンドウを分割するか、選択されたフレーム最下の既存ウィンドウを再利用する。

Function: display-buffer-use-some-window buffer alist

この関数は既存のウィンドウを選択して、そのウィンドウ内にbufferを表示することによりバッファーの表示を試みる。すべてのウィンドウが他のバッファー専用なら、この関数は失敗する可能性がある(Dedicated Windowsを参照)。

Function: display-buffer-no-window buffer alist

alistに非nilallow-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-actiondisplay-buffer-fallback-actionが指示するものを使用して処理を行う。

さらにdisplay-bufferは、(display-bufferにより*foo*が前からそこに配置されていた場合は)再使用されるウィンドウ、およびポップアップされたウィンドウにたいして調整を試みます。そのウィンドウが垂直コンビネーションの一部なら、高さはその行数にセットされるでしょう。数字“10”のかわりに関数fit-window-to-bufferを指定した場合、display-bufferは空のバッファーにフィットするようにウィンドウを1行にセットするでしょう。ウィンドウが水平コンビネーションの一部なら、列数を40にセットします。新たなウィンドウが垂直または水平に組み合わせられるかは、ウィンドウの分割方向とsplit-window-preferred-functionsplit-height-thresholdsplit-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-bufferaction引数内の行数に対応する指定をオーバーライドする、行数“5”へのセットを試みることに注意してください。