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

42.12.6 フェイスを扱う関数

顔の作成や操作を行うための追加機能をご紹介します。

関数: face-list

この関数は、定義済みのすべての面名のリストを返します。

関数: face-id face

この関数は、フェイス face のフェイス番号を返します。これは、Emacs の低レベルにおいてフェイスを一意に識別するための番号です。フェイス番号を用いてフェイスを参照する必要はほとんどありません。しかし、make-glyph-code や glyph-face(グリフ を参照)のようにグリフを操作する関数は、内部的にフェイス番号にアクセスします。なお、フェイス番号はフェイスシンボルの face プロパティの値として格納されているため、フェイスのこのプロパティに独自の値を設定しないことを推奨します。

関数: face-documentation face

This function returns the documentation string of face face, or nil if none was specified for it.

関数: face-equal face1 face2 &optional frame

面 face1 と face2 の表示属性が同一の場合、t を返します。

関数: face-differs-from-default-p face &optional frame

これは、フェイス face がデフォルトのフェイスとは異なる表示になる場合に、nil 以外の値を返します。

フェイスエイリアスは、フェイスに同等の名前を付与するものです。エイリアスシンボルにface-aliasプロパティを指定し、その値に対象のフェイス名を設定することで、フェイスエイリアスを定義できます。以下の例では、modelineをmode-lineフェイスのエイリアスとして設定しています。

(put 'modeline 'face-alias 'mode-line)
マクロ: define-obsolete-face-alias obsolete-face current-face when

このマクロは、obsolete-face を current-face のエイリアスとして定義するとともに、将来的に削除される可能性があることを示すため、これを廃止済みとしてマークします。when は、obsolete-face が廃止された時期を示す文字列(通常はバージョン番号の文字列)とする必要があります。