以下のフレームパラメーターはウィンドウマネージャーやウィンドウシステムとフレームとの相互作用のさまざまな面を制御します。これらはテキスト端末上では効果がありません。
visibility
¶フレームの可視性(visibility)の状態。可能な値は3つありnil
は不可視、t
は可視、icon
はアイコン化されていることを意味する。フレームの可視性を参照のこと。
auto-raise
¶非nil
なら、Emacsはそのフレーム選択時に自動的にそれを前面に移動(raise)する。これを許さないウィンドウマネージャーがいくつかある。
auto-lower
¶非nil
なら、Emacsはそのフレームの選択解除時に自動的にそれを背面に移動(lower)する。これを許さないウィンドウマネージャーがいくつかある。
icon-type
¶そのフレームに使用するアイコンのタイプ。値が文字列なら使用するビットマップを含むファイル、nil
ならアイコンなしを指定する(何を表示するかはウィンドウマネージャーが決定する)。その他の非nil
値はデフォルトのEmacsアイコンを指定する。
icon-name
¶このフレームにたいするアイコンで使用する名前。アイコンを表示する場合は、その際に表示される。これがnil
ならフレームのタイトルが使用される。
window-id
¶グラフィカルディスプレイがこのフレームにたいして使用するID番号。Emacsはフレーム作成時にこのパラメーターを割り当てる。このパラメーターを変更しても実際のID番号に効果はない。
outer-window-id
¶そのフレームが存在する最外殻のウィンドウシステムのウィンドウのID番号。window-id
と同じように、このパラメーターを変更しても実際の効果はない。
wait-for-wm
¶非nil
ならジオメトリー変更を確認するために、ウィンドウマネージャーを待機するようXtに指示する。Fvwm2およびKDEのバージョンを含むウィンドウマネージャーのいくつかは確認に失敗してXtがハングする。これらウィンドウマネージャーのハングを防ぐためには、これをnil
にセットすること。
sticky
¶非nil
なら仮想デスクトップを伴うシステム上のすべての仮想デスクトップ上でそのフレームが可視になる。
shaded
¶非nil
ならウィンドウマネージャーにたいして、タイトルバーを残しコンテンツが隠れるようにフレームを表示するよう指示する。
use-frame-synchronization
¶非nil
ならグラフィックのティアリングを防ぐために、フレームの再表示とモニターのリフレッシュレートを同期させる。これは現時点ではHaiku、および非ツールキットとXツールキットとともにビルドされたXウィンドウシステムでのみ実際されており、ツールキットのスクロールバーでは正しく動作しない。更に関連するディスプレイ同期プロトコルをサポートするコンポジット型ウィンドウマネージャーを要求する。XリソースのsynchronizeResize
にも文字列"extended"
がセットされていなければならない。
inhibit-double-buffering
¶非nil
ならフレームはダブルバッファリングなしでスクリーンに描画される。通常はちらつきを減少させるために、利用可能ならEmacsはダブルバッファリングの使用を試みる。これはダブルバッファリングが不正な表示を誘発する状況にたいして提供されているパラメーターではあるが、かつてEmacsを悩ませてきた太古のちらつきに郷愁を覚える変人にたいして提供されたパラメーターともいえる。
skip-taskbar
¶非nil
ならウィンドウマネージャーならフレームのディスプレイに関連するタスクバーからフレームのアイコンを削除して、Alt-TABのコンビネーションキーを通じたフレームへの切り替えを抑制するようにウィンドウマネージャーに指示する。MS-Windowsではこのようなフレームをアイコン化するとデスクトップ下部にある、フレームにたいするウィンドウシステムのウィンドウに"ロールイン(roll
in)"される。いくつかのウィンドウマネージャーはこのパラメーターにしたがわない。
no-focus-on-map
¶非nil
ならフレームはマップ時に入力フォーカスの受け取りを希望しないことを意味する。いくつかのウィンドウマネージャーはこのパラメーターにしたがわない。
no-accept-focus
¶非nil
ならフレームは明示的なマウスクリックやfocus-follows-mouse
(入力のフォーカスを参照)、mouse-autoselect-window
(マウスによるウィンドウの自動選択を参照)によりマウスがフレーム内に移動した際に入力フォーカスの受け取りを希望しないことを意味する。これはユーザーが選択されていないフレームをマウスでスクロールできないという、望ましくない副作用をもたらすかもしれない。いくつかのウィンドウマネージャーはこのパラメーターにしたがわない。HaikuでもたとえユーザーがAlt-TABというキー組み合わせでそのフレームに切り替えた場合であっても、ウィンドウがユーザーからのキーボード入力を何も受け取ることができないという副作用があるだろう。
undecorated
¶非nil
ならフレームのウィンドウシステムのウィンドウはタイトル、最小化ボックスや最大化ボックス、エクスターナルボーダーのような装飾なしで描画される。これは通常はマウスによるそのウィンドウシステムのウィンドウのドラッグ、リサイズ、アイコン化、最大化、削除ができないことを意味する。nil
の場合にはウィンドウマネージャーのセッティングでディスプレイがサスペンドされていなければ、フレームのウィンドウは上述のすべての要素とともに描画される。
Xでは装飾をオフに切り替えるために、EmacsはMotifウィンドウマネージャーのヒントを使用する。いくつかのウィンドウマネージャーはこれらのヒントにしたがわない。
NSビルドはツールバーを装飾とみなすので未装飾のフレームでは表示されない。
override-redirect
¶非nil
ならオーバーライド・リダイレクト(override
redirect)のフレームであることを意味する。これはフレームがX配下のウィンドウマネージャーで処理されないことを意味する。オーバーライド・リダイレクト・フレームはウィンドウマネージャーの装飾をもたず、Emacsの配置関数やリサイズ関数でしか配置やリサイズができない。また他のすべてのフレームの最上位に通常は描画される。このパラメーターをセットしてもMS-Windowsでは効果がない。
ns-appearance
¶macOSのみ利用可能でありdark
にセットすると“vibrant
dark”テーマ、light
にセットすると“aqua”テーマ、それ以外ならシステムのデフォルトを使用してフレームのウィンドウシステムのウィンドウを描画する。暗色(dark)のバックグラウンドのEmacsテーマ使用時にツールバーやスクロールバーに暗色の外観をセットするために“vibrant
dark”テーマを使用できる。
ns-transparent-titlebar
¶macOSでのみ利用可能であり非nil
ならタイトルバーとツールバーをトランスペアレント(transparent:
透明)にセットする。これはEmacsのバックグラウンドカラーにマッチするようにタイトルバーとツールバーのバックグラウンドカラーを効果的にセットする。