Подсказки

Подсказки — это специальные фреймы (см. Фреймы), используемые для отображения полезных подсказок (также называемых «советами»), связанных с текущим положением указателя мыши. Emacs использует подсказки для отображения справочных строк о фрагментах текста с активными свойствами (см. Свойства с особым смыслом) и о различных элементах пользовательского интерфейса, таких как пункты меню (см. Расширенные пункты меню) и кнопки панели инструментов (см. Панели инструментов).

Функция: tooltip-mode

Режим подсказок — это второстепенный режим, включающий отображение подсказок. При выключении этого режима подсказки отображаются в области эха. В текстовых фреймах (также называемых «TTY») подсказки всегда отображаются в области эха.

Если Emacs собран с поддержкой набора инструментов GTK+ или оконной системы Haiku, по умолчанию он отображает подсказки с помощью функций набора инструментов, а их внешний вид определяется настройками этого набора инструментов. Подсказки, предоставляемые набором инструментов, можно отключить, изменив значение переменной use-system-tooltips на nil. В остальной части этого подраздела описывается, как управлять подсказками, не предоставляемыми набором инструментов, которые отображаются самим Emacs.

Подсказки отображаются в специальных фреймах, называемых фреймами подсказок, у которых есть собственные параметры фрейма (см. Параметры фрейма). В отличие от других фреймов, параметры по умолчанию для фреймов подсказок хранятся в специальной переменной.

Пользовательская опция: tooltip-frame-parameters

Этот настраиваемый параметр содержит параметры фрейма по умолчанию, используемые для отображения подсказок. Все параметры шрифта и цвета игнорируются; вместо них используются соответствующие атрибуты грани tooltip. Если включены параметры left или top, они используются как абсолютные координаты относительно фрейма, в которых должна отображаться подсказка. (Положение подсказки относительно мыши можно настроить с помощью переменных, описанных в разделе Подсказки в Руководстве GNU Emacs.) Обратите внимание: параметры left и top, если они указаны, переопределяют значения смещений относительно мыши.

Грань tooltip определяет внешний вид текста, отображаемого в подсказках. Обычно для неё следует использовать шрифт с пропорциональной шириной символов, размер которого желательно должен быть меньше размера шрифта фрейма по умолчанию.

Переменная: tooltip-functions

Этот нестандартный хук представляет собой список функций, вызываемых, когда Emacs требуется отобразить подсказку. Каждая функция вызывается с одним аргументом event, который представляет собой копию последнего события перемещения мыши. Если функция из этого списка действительно отображает подсказку, она должна возвращать значение, отличное от nil, после чего остальные функции вызываться не будут. Значение этой переменной по умолчанию — одна функция tooltip-help-tips.

Если вы пишете собственную функцию для добавления в список tooltip-functions, вам может понадобиться узнать буфер, в котором произошло событие мыши, вызвавшее отображение подсказки. Следующая функция предоставляет эту информацию.

Функция: tooltip-event-buffer event

Эта функция возвращает буфер, над которым произошло событие event. Вызовите её с аргументом функции из tooltip-functions, чтобы получить буфер, текст которого вызвал отображение подсказки. Обратите внимание: событие может произойти не над буфером (например, над панелью инструментов), и в таком случае эта функция вернёт nil.

Другие аспекты отображения подсказок регулируются несколькими настраиваемыми параметрами; см. раздел Подсказки в Руководстве GNU Emacs.