Встроенные родные виджеты

Emacs способен отображать родные виджеты, такие как виджеты GTK+ WebKit, в буферах Emacs, когда он был скомпилирован с необходимыми библиотеками поддержки и работает в графическом терминале. Чтобы проверить, поддерживает ли Emacs отображение встроенных виджетов, проверьте, доступна ли функция xwidget-internal (см. Имена функций).

Чтобы отобразить встроенный виджет в буфере, необходимо сначала создать объект xwidget, а затем использовать этот объект в качестве спецификатора отображения в свойстве текста или наложения display (см. Свойство отображения).

Функция: make-xwidget тип заголовок ширина высота аргументы &optional буфер

Это создаёт и возвращает объект xwidget. Если буфер опущен или nil, по умолчанию используется текущий буфер. Если буфер указывает на несуществующий буфер, он будет создан. Тип определяет тип компонента xwidget, он может быть одним из следующих:

webkit

Компонент WebKit.

Аргументы ширина и высота задают размер виджета в пикселях, а заголовок, строка, задаёт его заголовок.

Функция: xwidgetp объект

Эта функция возвращает t, если объект является xwidget, и nil, в противном случае.

Функция: xwidget-plist xwidget

Эта функция возвращает список свойств xwidget.

Функция: set-xwidget-plist xwidget plist

Эта функция заменяет список свойств xwidget новым списком свойств, заданным plist.

Функция: xwidget-buffer xwidget

Эта функция возвращает буфер xwidget.

Функция: get-buffer-xwidgets буфер

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

Функция: xwidget-webkit-goto-uri xwidget uri

Эта функция переходит по указанному uri в заданном xwidget. uri — это строка, которая указывает имя файла или URL.

Функция: xwidget-webkit-execute-script xwidget сценарий

Эта функция заставляет виджет браузера, заданный xwidget, выполнить указанный JavaScript-script.

Функция: xwidget-webkit-execute-script-rv xwidget сценарий &optional значение по умолчанию

Эта функция выполняет указанный сценарий, как и xwidget-webkit-execute-script , но также возвращает возвращаемое значение сценария как строку. Если сценарий не возвращает значения, эта функция возвращает значение по умолчанию, или nil, если значение по умолчанию было опущено.

Функция: xwidget-webkit-get-title xwidget

Эта функция возвращает заголовок xwidget в виде строки.

Функция: xwidget-resize xwidget ширина высота

Эта функция изменяет размер указанного xwidget до размера ширинаxвысота пикселей.

Функция: xwidget-size-request xwidget

Эта функция возвращает желаемый размер xwidget в виде списка вида (width height). Размеры в пикселях.

Функция: xwidget-info xwidget

Эта функция возвращает атрибуты xwidget как вектор вида [type title width height]. Атрибуты обычно определяются make-xwidget, когда xwidget создаётся.

Функция: set-xwidget-query-on-exit-flag xwidget флаг

Эта функция позволяет организовать запрос Emacs у пользователя о подтверждении перед выходом или перед уничтожением буфера, связанного с xwidget. Если флаг не nil, Emacs запросит подтверждение у пользователя, иначе — нет.

Функция: xwidget-query-on-exit-flag xwidget

Эта функция возвращает текущее значение флага запроса на выход для xwidget: t или nil.