Вызывается при вставке картинки или файла (файлов) из буфера обмена на активной форме.
Синтаксис
ПриВставкеИзБуфераОбмена(<Значение>, <СтандартнаяОбработка>)Полное описание, параметры и ограничения
ФормаКлиентскогоПриложения.ПриВставкеИзБуфераОбмена (ClientApplicationForm.OnPasteFromClipboard)
ФормаКлиентскогоПриложения (ClientApplicationForm)
ПриВставкеИзБуфераОбмена (OnPasteFromClipboard)
Доступен, начиная с версии 8.3.24.
Синтаксис:
ПриВставкеИзБуфераОбмена(<Значение>, <СтандартнаяОбработка>)
Параметры:
<Значение>
Тип: Картинка, Массив.
Значение, полученное из буфера обмена.
Картинка или массив из элементов типа СсылкаНаФайл.
<СтандартнаяОбработка>
Тип: Булево.
В данный параметр передается признак выполнения стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная обработка события производиться не будет.
Значение по умолчанию: Истина.
Описание:
Вызывается при вставке картинки или файла (файлов) из буфера обмена на активной форме.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.3.24.
Методическая информация
Практические примеры
Отклонить вставку файлов и изображений в учебную панель
Событие относится к картинкам и файлам из буфера, не к обычной вставке текста в поле ввода.
Где и как запускать
Модуль управляемой формы, указанной в подготовке. Директивы &НаКлиенте и &НаСервере уже включены в код.
Подготовка
В отдельной учебной конфигурации создайте обработку УчебнаяПанель и управляемую форму Панель. Код обработчика вставляйте на уровне модуля формы.
В свойствах формы на вкладке События назначьте указанному событию одноимённую процедуру. Обновите только учебную базу; проверяйте в тонком клиенте.
Добавьте РазрешитьВложения (Булево), выведите флажок. Начальное значение Ложь. Назначьте событие ПриВставкеИзБуфераОбмена.
Для проверки скопируйте небольшой несекретный файл или изображение. Не используйте рабочие документы; код ничего не загружает и не сохраняет.
&НаКлиенте
Процедура ПриВставкеИзБуфераОбмена(Значение, СтандартнаяОбработка)
Если Не РазрешитьВложения Тогда
СтандартнаяОбработка = Ложь;
Сообщить("В этой панели вложения не принимаются");
КонецЕсли;
КонецПроцедурыРазбор по шагам
Платформа передаёт картинку или массив ссылок на файлы.
При выключенном флажке запрещаем стандартную обработку вставки.
При включённом оставляем платформе её обычное поведение: пользовательская загрузка в этом уроке не реализована.
Как проверить результат
При выключенном флажке попытка вставить файл или картинку показывает сообщение и отменяет стандартную обработку.
Вставка обычного текста в строковое поле не является тестом данного события.
Ожидаемый результат
Для файлов и изображений применено явное правило приёма вложений.
На что обратить внимание
Разрешение стандартной обработки само по себе не означает сохранение файла в базе.
Поведение буфера и доступность файлов зависят от клиента и его разрешений.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.