42.12.6 操作文本视觉样式的函数

以下是用于创建和操作文本视觉样式的其他函数。

Function: face-list

该函数返回所有已定义的文本视觉样式名称列表。

Function: face-id face

该函数返回文本视觉样式 face文本视觉样式编号(face number)。 这是一个在 Emacs 底层唯一标识文本视觉样式的数字。 通常很少需要通过文本视觉样式编号来引用样式。 但是,操作字形的函数(如 make-glyph-codeglyph-face,see 字形) 会在内部使用文本视觉样式编号。 注意,文本视觉样式编号存储在文本视觉样式符号的 face 属性值中, 因此建议不要自行将该属性设为其他值。

Function: face-documentation face

该函数返回文本视觉样式 face 的文档字符串, 若未指定则返回 nil

Function: face-equal face1 face2 &optional frame

若文本视觉样式 face1face2 用于显示时属性完全相同, 则返回 t

Function: face-differs-from-default-p face &optional frame

若文本视觉样式 face 的显示效果与默认文本视觉样式不同, 则返回非 nil

文本视觉样式别名(face alias) 为一个文本视觉样式提供等效名称。 你可以为别名字符设置 face-alias 属性, 其值为目标文本视觉样式名称,以此定义别名。 下面的示例将 modeline 设为 mode-line 文本视觉样式的别名。

(put 'modeline 'face-alias 'mode-line)
Macro: define-obsolete-face-alias obsolete-face current-face when

该宏将 obsolete-face 定义为 current-face 的别名, 并将其标记为已废弃,表明未来可能移除。 when 应为字符串,说明该别名从何时起废弃(通常为版本号字符串)。