Next: Buffer Display Action Functions, Up: Displaying Buffers [Contents][Index]
コマンドdisplay-buffer
は表示のために柔軟にウィンドウを選択して、そのウィンドウ内に指定されたバッファーを表示します。これはキーバインディングC-x
4
C-oを通じてインタラクティブに呼び出すことができます。またswitch-to-buffer
やpop-to-buffer
を含む多くの関数やコマンドにからサブルーチンとしても使用されます(Switching Buffersを参照)。
このコマンドはウィンドウ内に表示するウィンドウを探すために、いくつかの複雑なステップを実行します。これらのステップはディスプレイアクション(display
actions)を用いて記述されます。ディスプレイアクションは(functions
.
alist)
という形式をもちます。ここでfunctionsは“アクション関数”と呼ばれる単一の関数か関数のリスト(Buffer Display Action Functionsを参照)、alistは“アクションalist”と呼ばれる連想リストです(Buffer Display Action Alistsを参照)。ディスプレイ表示の例についてはThe Zen of Buffer Displayを参照してください。
アクション関数は、表示するバッファーと、アクションalistという、2つの引数を受け取ります。これは、自身の条件にしたがってウィンドウウィンドウ選択、または作成して、バッファーをウィンドウ内に表示します。成功した場合はそのウィンドウ、それ以外はnil
をリターンします。
display-buffer
は複数ソースからのディスプレイアクションを組み合わせて、アクション関数のいずれか1つがバッファーの表示を管理して非nil
値をリターンするまでアクション関数を順に呼び出します。
このコマンドは、ウィンドウウィンドウ選択したり、そのバッファーをカレントにすることなく、buffer-or-nameをウィンドウに表示させる。引数buffer-or-nameはバッファー、または既存のバッファーの名前でなければならない。リターン値はバッファーを表示するために選ばれたウィンドウ、適切なウィンドウが見つからなければnil
。
オプション引数actionが非nil
なら、それは通常はディスプレイアクション(上述)であること。display-buffer
は以下のソース(優先度の高位順)からディスプレイアクションを集約してアクション関数リストとアクションalistを構築する:
display-buffer-overriding-action
。
display-buffer-alist
。
display-buffer-base-action
。
display-buffer-fallback-action
。
実際のところは、これらのディプレイアクションにより指定されるアクション関数すべてのリストをdisplay-buffer
が構築することを意味する。このリストの最初の要素は(もしあれば)
display-buffer-overriding-action
が指定する最初のアクション関数。display-buffer-pop-up-frame
の最後の要素はdisplay-buffer-fallback-action
が指定する最後のアクション関数。このリストから重複要素は削除されないので、1回のdisplay-buffer
呼び出しの間に同一のアクション関数が複数回呼び出されるかもしれない。
display-buffer
はバッファーを1つ目の引数、組み合わされたalistを2つ目の引数として、いずれかの関数が非nil
をリターンするまで、このリスト内で指定されたアクション関数を順に呼び出す。異なるソースから指定されたディスプレイアクションをdisplay-buffer
がどのように処理するかの例はPrecedence of Action Functionsを参照のこと。
2つ目の引数は常に、上記に挙げたソースが指定するすべてのアクションalistエントリーのリストであることに注意。したがってこのリストの最初の要素は(もしあれば)
display-buffer-overriding-action
が指定する最初のアクションalistエントリー、最後の要素はもしあれば(display-buffer-fallback-action
のアクションalistが空)
display-buffer-base-action
の最後のalistエントリーとなる。
組み合わされたアクションalistは重複したエントリーを含むかもしれず、同じキーにたするエントリーが異なる値をもつかもしれないことにも注意。アクション関数はルールとして見つかった最初のキーの連想値を常に使用する。したがってアクション関数の連想値が、そのアクション関数が指定するディスプレイアクションにより提供される連想値を使用する必要はない。
引数actionには非nil
の非list値も指定できる。これはたとえ選択されたウィンドウがすでにそのバッファーを表示していても、選択されたウィンドウではない別のウィンドウにバッファーが表示されるべきという特別な意味をもつ。プレフィックス引数とともにインタラクティブに呼び出された場合には、actionはt
である。Lispプログラムは常にリス値を提供すること。
オプション引数frameが非nil
の場合は、そのバッファーがすでに表示されているか判断する際、どのフレームをチェックするかを指定する。これはactionのアクションalistに要素(reusable-frames . frame)
を追加するのと等価(Buffer Display Action Alistsを参照)。frameは互換性のために提供される引数であり、Lispプログラムが使用するべきではない。
この変数の値はdisplay-buffer
により最高の優先順で扱われるディスプレイアクションであること。デフォルト値は空のディスプレイアクション(つまり(nil . nil)
)。
このオプションの値はディスプレイアクションにコンディション(condition:
状態)をマップするalist。コンディションはそれぞれバッファー名にマッチする正規表現、または2つの引数をとる関数であり、引数はバッファー名とdisplay-buffer
に渡すaction引数。display-buffer
に渡されたバッファー名がこのalist内の正規表現にマッチするか、あるいはコンディションで指定された関数が非nil
をリターンした場合には、display-buffer
はバッファーを表示すために対応するディスプレイアクションを使用する。
このオプションの値はディスプレイアクションであること。このオプションはdisplay-buffer
呼び出しにたいする標準のディスプレイアクションを定義するために使用できる。
このディスプレイアクションはdisplay-buffer
にたいして、他のディスプレイアクションが与えられなかった場合の代替え処理を指定する。