Подсказки

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

Функция: tooltip-mode

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

Когда Emacs построен с поддержкой GTK+, по умолчанию он отображает подсказки с помощью функций GTK+, а внешний вид подсказок затем контролируется настройками GTK+. Подсказки GTK+ можно отключить, изменив значение переменной x-gtk-use-system-tooltips на nil. Остальная часть этого раздела описывает, как контролировать подсказки, не использующие GTK+, которые представляются самим 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.