Возникает перед интерактивной печатью объекта (при выборе пользователем команды "Печать" или "Печать с текущими настройками").
Синтаксис
ПередПечатью(<ДиалогПечати>, <Отказ>)Полное описание, параметры и ограничения
Расширение поля формы для поля табличного документа.ПередПечатью (Form field extension for a spreadsheet document field.BeforePrint)
Расширение поля формы для поля табличного документа (Form field extension for a spreadsheet document field)
ПередПечатью (BeforePrint)
Доступен, начиная с версии 8.3.15.
Синтаксис:
ПередПечатью(<ДиалогПечати>, <Отказ>)
Параметры:
<ДиалогПечати>
Тип: РежимИспользованияДиалогаПечати.
Способ вызова печати:
НеИспользовать - если выбрана команда "Печать с текущими настройками",
Использовать - если выбрана команда "Печать".
<Отказ>
Тип: Булево.
Признак отказа от печати. Если в теле процедуры-обработчика установить данному параметру значение Истина, то печать выполнена не будет.
Значение по умолчанию: Ложь.
Описание:
Возникает перед интерактивной печатью объекта (при выборе пользователем команды "Печать" или "Печать с текущими настройками").
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.3.15.
Методическая информация
Практические примеры
Отменить учебную печать до отправки на принтер: табличного документа
Возникает перед интерактивной печатью объекта (при выборе пользователем команды "Печать" или "Печать с текущими настройками"). Отменить учебную печать до отправки на принтер.
Где и как запускать
Клиентский модуль собственной управляемой формы. Элемент передаёт платформа; дополнительный блок — отдельный серверный обработчик создания.
Подготовка
Создайте внешнюю учебную обработку с управляемой формой. Реквизиты формы: Статус (Строка 200), Счетчик (Число 10.0), РазрешитьСохранение (Булево). Выведите Статус и РазрешитьСохранение на форму.
Основной обработчик назначается событию указанного элемента Образец, а не событию формы. Код вставляется на уровне модуля формы с директивой НаКлиенте. Дополнительный серверный блок назначьте событию формы ПриСозданииНаСервере.
Открывайте обработку в настольном тонком клиенте. Каждый урок проверяйте в отдельном варианте формы; HTML показывает код, но не исполняет его.
Добавьте реквизит УчебныйДокумент типа ТабличныйДокумент и элемент Образец вида ПолеТабличногоДокумента, путь к данным УчебныйДокумент. У поля Редактирование Истина и Защита Ложь; ячейка A1 разрешена для интерактивного редактирования.
В свойствах элемента Образец → События назначьте ПередПечатью процедуре ОбразецПередПечатью. Подготовка использует текущую сигнатуру установленной справки плюс неявный параметр Элемент управляемой формы.
&НаКлиенте
Процедура ОбразецПередПечатью(Элемент, ДиалогПечати, Отказ)
Отказ = Истина;
Статус = "Печать учебного образца отменена";
Сообщить(Статус);
КонецПроцедурыПодготовить собственное содержимое формы
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Счетчик = 0;
РазрешитьСохранение = Ложь;
Статус = "Готово";
Документ = Новый ТабличныйДокумент;
Ячейка = Документ.Область(1, 1);
Ячейка.Текст = "Книга";
Ячейка.Расшифровка = "УЧЕБНЫЙ-КОД";
Ячейка.Защита = Ложь;
УчебныйДокумент = Документ;
Элементы.Образец.Редактирование = Истина;
Элементы.Образец.Защита = Ложь;
Элементы.Образец.Вывод = ИспользованиеВывода.Разрешить;
КонецПроцедурыРазбор по шагам
Дополнительный серверный блок создаёт собственные данные, элемент подготовлен в редакторе формы.
Платформа вызывает назначенный обработчик вследствие действия пользователя; процедуру с придуманными параметрами вручную не вызываем.
Обработчик меняет только явно названные данные своей формы или параметры текущего события.
Как проверить результат
Выберите интерактивную команду печати: обработчик сообщает об отмене.
Задание на принтер не отправляется. ДиалогПечати описывает способ вызова, но не разрешает игнорировать Отказ.
Ожидаемый результат
Отменить учебную печать до отправки на принтер на собственном подготовленном элементе.
На что обратить внимание
Настольный тонкий клиент — контекст этого урока. Доступность и порядок событий в веб- и мобильном клиентах могут отличаться.
Код не открывает внешние страницы, не отправляет сообщения и не обращается к рабочим документам.
Свойство СтандартнаяОбработка и параметр Отказ имеют разные назначения: первый заменяет стандартное действие, второй отменяет операцию.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.