События Xwidget

Xwidgets (см. Встроенные нативные виджеты) могут отправлять события, чтобы обновлять программы Lisp, сообщая им о своём состоянии. Эти события называются xwidget-events и содержат различные данные, описывающие характер изменения.

(xwidget-event kind xwidget arg)

Это событие отправляется при любом обновлении xwidget. Существует несколько типов обновлений, определяемых их kind.

Это специальное событие (см. Специальные события), которое следует обрабатывать, добавив обратный вызов для xwidget. Он вызывается при получении события xwidget для xwidget.

Обратный вызов можно добавить, задав callback в списке свойств xwidget. Это должна быть функция, принимающая xwidget и kind в качестве аргументов.

load-changed

Это событие xwidget указывает, что xwidget достиг определённого этапа загрузки страницы. При отправке этих событий arg будет содержать строку, подробнее описывающую состояние виджета:

‘load-started’

Это означает, что виджет начал загружать страницу.

‘load-finished’

Это означает, что xwidget завершил обработку выполнявшейся операции загрузки страницы.

‘load-redirected’

Это означает, что во время загрузки страницы xwidget обнаружил перенаправление и последовал ему.

‘load-committed’

Это означает, что во время загрузки страницы xwidget подтвердил URL-адрес, то есть этот URL-адрес является окончательным и будет отображён xwidget в ходе текущей операции загрузки страницы.

download-callback

Это событие указывает, что загрузка файла завершена.

В приведённых выше событиях после arg могут следовать аргументы. Сам arg указывает URL-адрес, с которого был получен загруженный файл: первый аргумент после arg указывает MIME-тип загрузки в виде строки, а второй аргумент содержит полное имя загруженного файла.

download-started

Это событие указывает, что загрузка файла началась. В этих событиях arg содержит URL-адрес файла, который в данный момент загружается.

javascript-callback

Это событие содержит данные обратного вызова JavaScript. Эти события используются внутри xwidget-webkit-execute-script.

(xwidget-display-event xwidget source)

Это событие отправляется, когда xwidget запрашивает отображение другого xwidget. xwidget — это xwidget, который следует отобразить, а source — xwidget, запросивший отображение xwidget.

Это также специальное событие, которое следует обрабатывать с помощью обратных вызовов. Такой обратный вызов можно добавить, задав display-callback в списке свойств source. Это должна быть функция, принимающая xwidget и source в качестве аргументов.

Буфер xwidget будет установлен во временный буфер. При отображении виджета следует заменить этот буфер буфером, в котором будет отображаться xwidget, используя set-xwidget-buffer (см. Встроенные нативные виджеты).