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

30.4.3.4 レイアウトパラメータ

これらのフレームパラメータは、フレームの各種部分を有効または無効にしたり、そのサイズを制御したりします。特に断りのない限り、これらのパラメータはテキスト端末では意味を持ちません。

undecorated

nil 以外の場合、グラフィカルシステムでは、このフレームのウィンドウシステム上のウィンドウは、タイトルや最小化/最大化ボックス、外枠などの装飾なしで描画されます。通常、これはマウスでウィンドウをドラッグ、サイズ変更、アイコン化、最大化、または削除できないことを意味します。nil の場合、ウィンドウマネージャの設定で表示が停止されていない限り、通常はこのフレームのウィンドウに上述のすべての要素が描画されます。

X環境では、EmacsはMotifウィンドウマネージャのヒントを利用して装飾を無効にします。一部のウィンドウマネージャでは、これらのヒントが反映されない場合があります。

NSのビルドでは、ツールバーを装飾と見なすため、装飾のないフレームでは非表示にします。

テキスト端末において、このパラメータが nil 以外の場合、子フレームに外枠が表示され、マウスドラッグによるフレームのサイズ変更が可能になります(マウスドラッグパラメータを参照)。

border-width

フレームの外枠のピクセル単位の幅(フレームジオメトリを参照)。

internal-border-width

フレームの内側枠線のピクセル単位の幅(フレームジオメトリを参照)。

child-frame-border-width

指定されたフレームが子フレームである場合の、フレーム内部ボーダーのピクセル単位の幅(フレームジオメトリを参照)(子フレームを参照)。これが nil の場合は、代わりに internal-border-width パラメータで指定された値が使用されます。

vertical-scroll-bars

フレームに垂直スクロール用のスクロールバー(スクロールバーを参照)があるか、またそれがフレームのどちら側に配置されるか。指定可能な値は、スクロールバーなしの場合は left、right、nil です。

horizontal-scroll-bars

フレームに水平スクロール用のスクロールバーがあるか(t と bottom はあり、nil はない)。

scroll-bar-width

垂直スクロールバーの幅(ピクセル単位)、またはデフォルトの幅を使用する場合は nil。

scroll-bar-height

水平スクロールバーの高さ(ピクセル単位)、またはデフォルトの高さを使用する場合は nil。

left-fringe
right-fringe

このフレーム内のウィンドウの左右のフリンジのデフォルト幅(Fringesを参照)。いずれかが0の場合、対応するフリンジは実質的に削除されます。

frame-parameter を使用してこれら 2 つのフレームパラメータのいずれかの値をクエリする場合、戻り値は常に整数となります。set-frame-parameter を使用する場合、nil の値を渡すと、実際には 8 ピクセルのデフォルト値が設定されます。

right-divider-width

フレーム上の任意のウィンドウの右区切り線(ウィンドウ区切り線を参照)に割り当てられる幅(太さ)。単位はピクセル。値が0の場合は、右区切り線を描画しません。

bottom-divider-width

フレーム上の任意のウィンドウの下部区切り線(ウィンドウ区切り線を参照)に割り当てられる幅(厚さ)。単位はピクセル。値が0の場合は、下部区切り線を描画しません。

menu-bar-lines

メニューバー(メニューバーを参照)用にフレーム上部に割り当てる行数。メニューバーモードが有効な場合はデフォルトで1、それ以外の場合は0となります。The GNU Emacs Manualのメニューバーを参照してください。外部メニューバー(フレームレイアウトを参照)の場合、メニューバーが2行以上に折り返されても、この値は変更されません。その場合、frame-geometry(フレームジオメトリを参照)が返すmenu-bar-sizeの値を用いて、メニューバーが実際に1行以上を占有しているかどうかを判定できます。このパラメータは、テキスト端末のルートフレーム(子フレームを参照)におけるメニューバーの有無にも影響します。テキスト端末では、この値は0または1のみとなります。

tool-bar-lines

ツールバーに使用する行数(ツールバーを参照)。ツールバーモードが有効な場合はデフォルトで1、それ以外の場合は0となります。The GNU Emacs Manualのツールバーを参照してください。この値は、ツールバーが折り返されるたびに変更される場合があります(フレームレイアウトを参照)。

tool-bar-position

ツールバーの位置。その値は top、bottom、left、right のいずれかとなります。デフォルトは top です。

Nextstep以外のツールキットでビルドされたEmacsではbottomに、GTK+を使用したビルドではleftまたはrightに設定できます。

tab-bar-lines

タブバーに使用する行数(The GNU Emacs ManualのTab Barsを参照)。Tab Barモードが有効な場合はデフォルトで1、それ以外の場合は0となります。この値は、タブバーが折り返されるたびに変更される可能性があります(Frame Layoutを参照)。このパラメータは、テキスト端末のルートフレーム(Child Framesを参照)におけるタブバーの有無にも影響します。

line-spacing

各テキスト行の下に設ける追加スペース(ピクセル単位、正の整数)。詳細については、行高を参照してください。

no-special-glyphs

これが non-nil の場合、このフレームに表示されるすべてのバッファにおいて、切り捨てグリフ(切り捨てを参照)および継続グリフの表示が抑制されます。これは、fit-frame-to-buffer を用いてフレームをバッファに適合させる際に、こうしたグリフを排除するのに有用です(ウィンドウのサイズ変更を参照)。このフレームパラメータは、グラフィカルディスプレイに表示されるGUIフレームにおいてのみ、かつフリンジが無効な場合にのみ有効です。このパラメータは純粋に表示上の機能として意図されており、特にユーザーがインタラクティブにテキストを挿入できるフレームや、より一般的にカーソルが表示されるフレームでは使用すべきではありません。このパラメータが使用される代表的な例としては、ツールチップフレーム(ツールチップを参照)が挙げられます。このパラメータはテキスト端末にも影響を与えます。