Команды буфера кнопок

Это команды и функции для поиска и работы с кнопками в буфере Emacs.

push-button — это команда, которую пользователь использует для нажатия кнопки, и по умолчанию она связана с RET и mouse-2 с помощью локальной карты клавиш в наложении или свойствах текста кнопки. Команды, полезные вне самих кнопок, такие как forward-button и backward-button, также доступны в карте клавиш, хранящейся в button-buffer-map; режим, использующий кнопки, может захотеть использовать button-buffer-map в качестве родительской карты клавиш для своей карты. В качестве альтернативы, можно включить button-mode, что достигает аналогичного эффекта: это вспомогательный режим, который ничего не делает, кроме установки button-buffer-map как вспомогательной карты клавиш.

Если у кнопки есть свойство, отличное от nil follow-link, и mouse-1-click-follows-link установлено, быстрый щелчок mouse-1 также активирует команду push-button. См. Клик-текст.

Команда: push-button &optional pos use-mouse-action

Выполняет действие, указанное кнопкой в позиции pos. pos может быть либо позицией буфера, либо событием мыши. Если use-mouse-action не nil, или pos является событием мыши (см. События мыши), попробуйте вызвать свойство кнопки mouse-action вместо action; если у кнопки нет свойства mouse-action, используйте action как обычно. pos по умолчанию устанавливается в текущую позицию, за исключением случаев, когда push-button вызывается интерактивно в результате события мыши, в этом случае используется позиция события мыши. Если в позиции pos нет кнопки, ничего не происходит и возвращается nil, в противном случае возвращается t.

Команда: forward-button n &optional wrap display-message no-error

Перемещается к n-й следующей кнопке или n-й предыдущей кнопке, если n отрицательно. Если n равно нулю, перемещается к началу любой кнопки в текущей позиции. Если wrap не nil, перемещение за пределы буфера продолжается с другого конца. Если display-message не nil, отображается строка помощи кнопки. Любая кнопка с свойством, отличным от nil skip, пропускается. Возвращает найденную кнопку и сообщает об ошибке, если кнопки не найдены. Если no-error не nil, возвращается nil вместо сообщения об ошибке.

Команда: backward-button n &optional wrap display-message no-error

Перемещается к n-й предыдущей кнопке или n-й следующей кнопке, если n отрицательно. Если n равно нулю, перемещается к началу любой кнопки в текущей позиции. Если wrap не nil, перемещение за пределы буфера продолжается с другого конца. Если display-message не nil, отображается строка помощи кнопки. Любая кнопка с свойством, отличным от nil skip, пропускается. Возвращает найденную кнопку и сообщает об ошибке, если кнопки не найдены. Если no-error не nil, возвращается nil вместо сообщения об ошибке.

Функция: next-button pos &optional count-current

Функция: previous-button pos &optional count-current

Возвращает следующую кнопку после (для next-button) или перед (для previous-button) позиции pos в текущем буфере. Если count-current не nil, считает любую кнопку в pos при поиске, вместо того, чтобы начинать со следующей кнопки.