ДокументPDF.Напечатать

Методы · Print

Выводит PDF-документ на печать.

Синтаксис

Напечатать(<ДиалогПечати>)
Полное описание, параметры и ограничения

ДокументPDF.Напечатать (PDFDocument.Print)

ДокументPDF (PDFDocument)

Напечатать (Print)

Доступен, начиная с версии 8.3.21.

Синтаксис:
Напечатать(<ДиалогПечати>)
Параметры:

<ДиалогПечати> (необязательный)
Тип: РежимИспользованияДиалогаПечати.
Определяет необходимость показа диалога печати перед печатью.
Значение по умолчанию: НеИспользовать.
Описание:

Выводит PDF-документ на печать.

Доступность:

Тонкий клиент, веб-клиент, толстый клиент.

Использование в версии:

Доступен, начиная с версии 8.3.21.

Методическая информация

Практические примеры

Напечатать только собственный образец с обязательным диалогом

Печать защищена отдельной одноразовой фразой. Диалог даёт выбрать тестовое устройство или отменить: возврат процедуры не объявляется печатью на бумаге.

Где и как запускать

Полный модуль собственной управляемой формы внешней обработки, толстый клиент Windows 8.5.1.1343.

Подготовка

  1. Создайте отдельную собственную конфигурацию УчебнаяКонфигурацияСинтаксиса и внешнюю обработку с управляемой формой. Команда Выполнить связана с процедурой Выполнить, кнопка вызывает эту команду.

  2. Вставьте полный модуль одного урока на уровне модуля формы, не внутрь существующего обработчика. Серверная функция создаёт собственную таблицу Книга / 3 / 250 / 750 и возвращает настоящие PDF-байты.

  3. Используйте толстый клиент Windows платформы 8.5.1.1343. Серверу необходима возможность экспортировать табличный документ в PDF. Веб-клиент и его расширения этим уроком не проверяются.

  4. Окна имеют префикс guide-owned; закрывайте вручную только эти окна. Показать передаётся пустое имя файла, поэтому рабочий файл для автосохранения не назначается.

  5. Во время асинхронной операции не закрывайте форму и не запускайте второй экземпляр операции. Ждать означает ожидание завершения обещания, а не получение готового документа без ожидания.

  6. Только урок печати требует строковый реквизит формы Подтверждение. Печать разрешается отдельной фразой и обязательным диалогом, в котором пользователь сам выбирает собственное тестовое устройство или отменяет.

  7. При подготовке пособия эти окна и печать в 1С не запускались: проверки структуры не являются доказательством внешнего вида или физического вывода.

Перем СобственныйPDF;

&НаСервереБезКонтекста
Функция СоздатьСобственныеБайтыPDF()
    Таблица = Новый ТабличныйДокумент;
    Таблица.КодЯзыка = "ru";
    Таблица.Область(1, 1).Текст = "СОБСТВЕННЫЙ УЧЕБНЫЙ ОБРАЗЕЦ";
    Таблица.Область(2, 1).Текст = "Книга";
    Таблица.Область(2, 2).Текст = "3";
    Таблица.Область(2, 3).Текст = "250";
    Таблица.Область(2, 4).Текст = "750";
    Таблица.Область(1, 1, 2, 4).ЦветФона = Новый Цвет(255, 255, 210);
    Таблица.Область(, 1, , 1).ШиринаКолонки = 45;
    Поток = Новый ПотокВПамяти;
    Попытка
        Таблица.Записать(Поток, ТипФайлаТабличногоДокумента.PDF);
        Данные = Поток.ЗакрытьИПолучитьДвоичныеДанные();
    Исключение
        Поток.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Возврат Данные;
КонецФункции

&НаКлиенте
Функция ПрочитатьСобственныйДокумент(Данные)
    Поток = Данные.ОткрытьПотокДляЧтения();
    Попытка
        Документ = Новый ДокументPDF;
        Документ.Прочитать(Поток);
        Поток.Закрыть();
    Исключение
        Поток.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Возврат Документ;
КонецФункции

&НаКлиенте
Процедура Выполнить(Команда)
    Если Подтверждение <> "ПЕЧАТАЮ ТОЛЬКО УЧЕБНЫЙ PDF" Тогда
        ВызватьИсключение "Введите одноразовую фразу подтверждения печати собственного образца";
    КонецЕсли;
    Подтверждение = "";
    Данные = СоздатьСобственныеБайтыPDF();
    СобственныйPDF = ПрочитатьСобственныйДокумент(Данные);
    Если СобственныйPDF.КоличествоСтраниц() = 0 Тогда
        ВызватьИсключение "Нет собственной страницы для печати";
    КонецЕсли;
    СобственныйPDF.Напечатать(ИспользованиеДиалогаПечати.Использовать);
    Сообщить("Вызов печати вернулся; отмена диалога и физическая печать отдельно проверяются пользователем");
КонецПроцедуры

Разбор по шагам

  1. Создать строковый реквизит формы Подтверждение и поле ввода. Пустое или другое значение останавливает команду до получения документа.

  2. Введите ПЕЧАТАЮ ТОЛЬКО УЧЕБНЫЙ PDF. Фраза очищается до запуска, чтобы случайное второе нажатие не повторило печать.

  3. Создать и прочитать только собственную таблицу, проверить страницы и вызвать Напечатать с обязательным диалогом.

  4. В диалоге выбрать своё тестовое устройство и желаемое количество экземпляров либо отменить. Результат на бумаге проверить отдельно.

Как проверить результат

  1. Без точной фразы печать не запускается. После допуска фраза в форме пустая.

  2. Обязательно появляется диалог печати. При отмене нельзя утверждать, что образец напечатан; при печати проверьте Книга / 3 / 250 / 750.

Ожидаемый результат

Реальная клиентская печать собственного PDF с явным согласием пользователя на каждый запуск.

На что обратить внимание

  1. Создание пособия не выполняет этот код и не расходует бумагу. Команда урока при запуске пользователем действительно может напечатать образец.

  2. Напечатать — процедура, не Булево результата. Принтер может сообщить проблему позже возврата метода.

  3. Не убирайте диалог и одноразовую фразу; не заменяйте собственную таблицу рабочими данными.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.