Вставка медиа

Данные, сохранённые в выделениях оконной системы и буфере обмена MS-Windows, не ограничиваются обычным текстом. Данные выделения могут включать изображения или другие подобные двоичные данные, а также форматированный текст в формате HTML и PostScript. Поскольку типы данных выделения, соответствующие этим данным, отличаются от типов для обычного текста, вставку таких данных упрощает набор функций, называемых обработчиками вставки медиа. Они регистрируются каждым основным режимом, поддерживающим вставку таких данных, и вызываются при необходимости во время выполнения команды yank-media.

Функция: yank-media-handler types handler

Зарегистрировать обработчик вставки медиа, действующий в текущем буфере.

types может быть символом, обозначающим тип данных выделения (см. Доступ к выделениям), регулярным выражением для сопоставления с такими типами или списком таких символов и регулярных выражений. Например:

(yank-media-handler 'text/html #'my-html-handler)
(yank-media-handler "image/.*" #'my-image-handler)

Когда выделение предоставляет тип данных, соответствующий types, вызывается функция handler для вставки данных. Ей передаются символ, обозначающий соответствующий тип данных выделения, и данные, возвращённые gui-get-selection.

По умолчанию команда yank-media автоматически выбирает предпочтительный тип MIME. Правила выбора можно настроить с помощью переменных yank-media-autoselect-function и yank-media-preferred-types.

Переменная: yank-media-autoselect-function

Эта переменная должна задавать функцию, которой передаётся список типов MIME, доступных для текущего основного режима, и которая должна возвращать список предпочтительных типов MIME для использования. Команда yank-media всегда использует первый тип MIME в списке, если запрошен автоматический выбор.

Переменная: yank-media-preferred-types

Эта переменная изменяет процесс выбора по умолчанию команды yank-media-autoselect-function. Это список, который должен содержать единственный выбираемый тип MIME в порядке предпочтения. Он также может содержать функцию; в этом случае ей передаётся список доступных типов MIME, и она должна возвращать список предпочтительных типов MIME в порядке предпочтения. Этот список передаётся команде yank-media, поэтому при запросе автоматического выбора используется его первый элемент.

Команда yank-media-types показывает список доступных в данный момент типов данных выделения, что полезно при реализации обработчиков вставки медиа: программы часто предоставляют разнообразный и редко согласованный набор типов данных.