21.17.1.3 Menu Separators

メニューセパレーターは、テキストを表示するかわりに、水平ラインでメニューをサブパーツに分割する、メニューアイテムの一種です。メニューキーマップ内で、セパレーターは以下のように見えます:

(menu-item separator-type)

ここで、separator-typeは2つ以上のダッシュで始まる文字列です。

もっとも単純なケースでは、ダッシュだけでseparator-typeが構成されます。これはデフォルトのセパレーターを指定します(互換性のため、""と-もセパレーターとみなされる)。

separator-typeにたいする他の特定の値は、異なるスタイルのセパレーターを指定します。以下はそれらのテーブルです:

"--no-line"

"--space"

実際のラインではない、余分な垂直スペース。

"--single-line"

メニューのforegroundカラーの一重ライン。

"--double-line"

メニューのforegroundカラーの二重ライン。

"--single-dashed-line"

メニューのforegroundカラーの一重ダッシュライン。

"--double-dashed-line"

メニューのforegroundカラーの二重ダッシュライン。

"--shadow-etched-in"

3Dの窪んだ外観(3D sunken appearance)をもつ一重ライン。これはダッシュだけで構成されるセパレーターに使用されるデフォルトである。

"--shadow-etched-out"

3Dの浮き上がった外観(3D raised appearance)をもつ一重ライン。

"--shadow-etched-in-dash"

3Dの窪んだ外観(3D sunken appearance)をもつ一重ダッシュライン。

"--shadow-etched-out-dash"

3Dの浮き上がった外観(3D raised appearance)をもつ一重ダッシュライン。

"--shadow-double-etched-in"

3Dの窪んだ外観をもつ二重ライン。

"--shadow-double-etched-out"

3Dの浮き上がった外観をもつ二重ライン。

"--shadow-double-etched-in-dash"

3Dの窪んだ外観をもつ二重ダッシュライン。

"--shadow-double-etched-out-dash"

3Dの浮き上がった外観をもつ二重ダッシュライン。

2連ダッシュの後にコロンを追加して、1連ダッシュの後の単語の先頭の文字を大文字にすることにより、別のスタイルで名前を与えることもできます。つまり、"--:singleLine"は"--single-line"と等価です。

メニューセパレーターにたいして:enableや:visibleのようなキーワードを指定するために、長い形式を使用できます。

(menu-item separator-type nil . item-property-list)

たとえば:

(menu-item "--" nil :visible (boundp 'foo))

いくつかのシステムおよびディスプレイツールキットは、これらすべてのセパレータータイプを実際に処理しません。サポートされないタイプのセパレーターを使用した場合、メニューはサポートされている似た種別のセパレーターを表示します。