これらのフレームパラメータは、フレームの各種部分を有効または無効にしたり、そのサイズを制御したりします。特に断りのない限り、これらのパラメータはテキスト端末では意味を持ちません。
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フレームにおいてのみ、かつフリンジが無効な場合にのみ有効です。このパラメータは純粋に表示上の機能として意図されており、特にユーザーがインタラクティブにテキストを挿入できるフレームや、より一般的にカーソルが表示されるフレームでは使用すべきではありません。このパラメータが使用される代表的な例としては、ツールチップフレーム(ツールチップを参照)が挙げられます。このパラメータはテキスト端末にも影響を与えます。