Функции для работы с лицами

Ниже приведены дополнительные функции для создания и работы с лицами.

Функция: face-list

Эта функция возвращает список всех определённых имён лиц.

Функция: face-id face

Эта функция возвращает номер лица лица face. Это число, которое однозначно идентифицирует лицо на низком уровне в Emacs. Редко требуется ссылаться на лицо по его номеру. Однако функции, которые манипулируют глифами, такие как make-glyph-code и glyph-face (см. Глифы), обращаются к номерам лиц внутренне. Обратите внимание, что номер лица хранится в качестве значения свойства face символа лица, поэтому мы рекомендуем не устанавливать это свойство лица ни в какое значение по своему усмотрению.

Функция: face-documentation face

Эта функция возвращает строку документации лица face или nil, если для него не было указано ничего.

Функция: face-equal face1 face2 &optional frame

Это возвращает t, если лица face1 и face2 имеют одинаковые атрибуты для отображения.

Функция: face-differs-from-default-p face &optional frame

Это возвращает не-nil, если лицо face отображается по-другому, чем стандартное лицо.

Псевдоним лица предоставляет эквивалентное имя для лица. Вы можете определить псевдоним лица, присвоив символу псевдонима свойство 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 был признан устаревшим (обычно строка версии).