Выводит табличный документ на печать.
Синтаксис
Напечатать(<ДиалогПечати>)Примеры платформы
ТабДок.Напечатать();Полное описание, параметры и ограничения
ТабличныйДокумент.Напечатать (SpreadsheetDocument.Print)
ТабличныйДокумент (SpreadsheetDocument)
Напечатать (Print)
Доступен, начиная с версии 8.1.
Синтаксис:
Напечатать(<ДиалогПечати>)
Параметры:
<ДиалогПечати> (необязательный)
Тип: РежимИспользованияДиалогаПечати.
Определяет необходимость показа диалога печати перед печатью.
Значение по умолчанию: НеИспользовать.
Описание:
Выводит табличный документ на печать.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).
Примечание:
При выводе табличного документа на печать в файл PDF перенос строк в ячейках документа может быть выполнен с некоторыми отличиями от того, как он выполняется при отображении документа на экран. Это может повлиять на высоту строк, у которых указана автоматическая высота.
Пример:
ТабДок.Напечатать();
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Открыть печать двух учебных товаров с подтверждением
На каждой попытке требуется новая точная фраза. Метод вызывается с Использовать: диалог печати не пропускается.
Где и как запускать
Полный модуль собственной управляемой формы; толстый клиент Windows. Не запускать в рабочей конфигурации.
Подготовка
Создайте собственную отдельную учебную базу с именем конфигурации УчебнаяКонфигурацияСинтаксиса, внешнюю обработку и пустую управляемую форму. Откройте её в толстом клиенте Windows 8.5.1.1343.
Для командного урока создайте команду Выполнить, кнопку и действие Выполнить. Вставьте весь приведённый модуль, включая функции ниже процедуры.
Книга / 3 и Ручка / 1 создаются в новом табличном документе. Рабочие печатные формы, документы базы и файлы организации не используются.
Основной язык собственной конфигурации — ru. Урок языков дополнительно требует язык en. Языки создаются вручную в Конфигураторе; код не устанавливает их и не переводит текст автоматически.
Урок проверки печати требует установленного собственного тестового/виртуального принтера. На форме создайте строковый реквизит УчебныйПринтер и введите точное имя устройства.
Для реальной печати дополнительно нужен строковый реквизит Подтверждение. Для окна нужна отдельная команда СкрытьУчебноеОкно. Для сохранения первый запуск использует новый временный MXL, не существующий рабочий файл.
При создании руководства 1С, принтер и запись файла не запускались. Окна, драйвер и обратный вызов проверяются вручную в собственной учебной базе.
&НаКлиенте
Процедура Выполнить(Команда)
Если ПустаяСтрока(УчебныйПринтер) Тогда
ВызватьИсключение "Введите точное имя собственного тестового принтера";
КонецЕсли;
Если Подтверждение <> "ПЕЧАТАЮ ТОЛЬКО УЧЕБНЫЕ ДАННЫЕ" Тогда
ВызватьИсключение "Введите точную фразу подтверждения";
КонецЕсли;
Подтверждение = "";
Документ = СоздатьУчебныйДокумент();
Документ.ИмяПринтера = УчебныйПринтер;
Документ.КоличествоЭкземпляров = 1;
Сообщить(Документ.Область(2, 1).Текст = "Книга");
Сообщить(Документ.Область(3, 1).Текст = "Ручка");
Сообщить("Проверьте в диалоге точное устройство: " + УчебныйПринтер);
Документ.Напечатать(РежимИспользованияДиалогаПечати.Использовать);
КонецПроцедуры
&НаКлиенте
Функция СоздатьУчебныйДокумент()
Документ = Новый ТабличныйДокумент;
Документ.КодЯзыка = "ru";
Документ.Область(1, 1).Текст = "Товар";
Документ.Область(1, 2).Текст = "Количество";
Документ.Область(2, 1).Текст = "Книга";
Документ.Область(3, 1).Текст = "Ручка";
Документ.Область(2, 2).Текст = "3";
Документ.Область(3, 2).Текст = "1";
Документ.Область(, 1, , 1).ШиринаКолонки = 25;
Документ.Область(, 2, , 2).ШиринаКолонки = 12;
Возврат Документ;
КонецФункцииРазбор по шагам
Открыть только собственную учебную базу, задать имя тестового устройства и точную фразу ПЕЧАТАЮ ТОЛЬКО УЧЕБНЫЕ ДАННЫЕ.
Очистить фразу до вызова печати. Повторное нажатие не отправляет новое задание без нового подтверждения.
Создать только Книгу и Ручку, установить одну копию и проверить содержимое до вызова метода.
Открыть диалог через Использовать. В первом ручном тесте нажать Отмена и проверить, что задания на собственном устройстве нет.
Как проверить результат
Две проверки содержимого дают Истина.
Без точного подтверждения или имени устройства вызова печати нет. Возврат из Напечатать не трактуется как успешность печати.
Ожидаемый результат
Самостоятельный безопасно ограниченный образец ручного запуска печати.
На что обратить внимание
У Напечатать значение по умолчанию НеИспользовать: вызов без аргумента может печатать без диалога, здесь так делать нельзя.
Пользователь может поменять устройство в диалоге; перед подтверждением проверьте его вручную.
Если используете виртуальный PDF-принтер, выбирайте новый собственный файл и не перезаписывайте существующий.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.