Инструкция: как сделать кнопку печать в 1С 8.3

Разработка пользовательского интерфейса в конфигурациях на платформе 1С:Предприятие 8.3 требует от специалиста не только знания синтаксиса языка запросов, но и умения работать с формами документов. Одной из самых востребованных функций, которую часто необходимо добавить в типовую или самописную конфигурацию, является возможность быстрой отправки документа на принтер. Стандартный механизм платформы позволяет это делать, но часто требует программной доработки для реализации удобной кнопки прямо в форме объекта.

Процесс создания такой кнопки включает в себя несколько этапов: от добавления элемента управления на форму до написания обработчика события, который будет формировать печатную форму. Важно понимать, что платформа 1С не хранит готовые файлы документов в базе данных в виде привычных Word или PDF файлов при обычном вводе. Вместо этого она использует макеты или специализированные объекты компоновки данных, которые рендерятся в момент нажатия кнопки.

В данной статье мы разберем алгоритм действий, который позволит вам реализовать функционал печати для любого справочника или документа. Мы рассмотрим работу с объектом Макет, особенности вызова системного диалога печати и нюансы обработки исключительных ситуаций, когда принтер может быть недоступен или драйвер настроен некорректно.

Подготовка макета печатной формы в конфигураторе

Прежде чем выводить элемент на экран, необходимо создать саму основу документа — его визуальное представление. В конфигураторе это делается через дерево метаданных. Вам нужно выбрать объект (например, документ "Реализация товаров и услуг"), перейти на вкладку "Макеты" и создать новый макет. Тип макета обычно выбирается Обычный или Область компоновки данных, в зависимости от сложности верстки.

Внутри редактора макета вы можете использовать табличный документ как холст. Здесь размещаются статические надписи, такие как шапка документа, названия колонок и подписи. Для динамических данных, которые будут подставляться из базы, используются параметры. Имя параметра в макете должно совпадать с именем поля в запросе или структуре, которая будет передаваться при печати. Это критически важный момент для корректного отображения данных.

⚠️ Внимание: Не используйте жестко заданные размеры ячеек в табличном документе макета, если предполагается печать большого количества строк. Лучше настроить автоподбор высоты строки, иначе текст может обрезаться при выводе на принтер.

После верстки макета его необходимо сохранить и дать ему осмысленное имя, например, ПечатнаяФормаСчета. Это имя будет использоваться в коде программы для обращения к объекту. Если вы планируете использовать разные макеты для разных случаев (например, счет-фактура и товарная накладная), создайте отдельные макеты для каждого сценария использования.

Добавление кнопки на форму документа или справочника

Следующим шагом является модификация формы объекта. Откройте форму нужного документа в режиме редактирования. В палитре свойств найдите панель команд или область кнопок формы, куда вы хотите добавить новый элемент управления. Обычно кнопки печати размещают в верхней панели вместе с кнопками "Записать", "Провести" и "ОК".

Добавьте новую кнопку через контекстное меню палитры. В свойствах элемента укажите важное поле Вид — выберите значение Обычная кнопка. В поле Имя присвойте идентификатор, понятный разработчику, например, КнопкаПечать. В поле Заголовок напишите текст, который увидит пользователь, например, "Печать" или "Распечатать".

Обязательно настройте видимость кнопки. Если печать доступна только для проведенных документов, используйте свойство Видимость и привяжите его к условию или запишите логику в модуле формы. Это предотвратит попытки пользователей распечатать черновики, которые еще не утверждены бухгалтерией или отделом продаж.

⚠️ Внимание: Интерфейс такси (современный интерфейс 1С) имеет строгие гайдлайны по расположению элементов. Не размещайте кнопки печати в нижней части формы, если это не предусмотрено стандартом UX для данной роли пользователя.

Написание кода обработчика события нажатия

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

Первым делом нужно получить данные из текущего документа. Для этого используется объект формы или чтение данных напрямую из базы. Затем создается объект ТабличныйДокумент, в который загружается ранее созданный макет. Метод Область позволяет выбрать конкретную часть макета, если он состоит из нескольких секций.

Процедура КнопкаПечатьНажатие(Кнопка)
ТабДок = Новый ТабличныйДокумент;
Макет = ПолучитьМакет("ПечатнаяФормаСчета");
ОбластьМакета = Макет.Область("Основная");

// Заполнение параметров макета
Параметры = Новый Структура;
Параметры.Вставить("Номер", Объект.Номер);
Параметры.Вставить("Дата", Объект.Дата);
Параметры.Вставить("Контрагент", Объект.Контрагент);

ТабДок.Вывести(ОбластьМакета, Параметры);
ТабДок.Показать();
КонецПроцедуры

В приведенном примере используется метод Показать(), который открывает предпросмотр. Однако для прямой отправки на принтер без показа окна предпросмотра используется метод Печать(). Выбор метода зависит от требований заказчика: нужна ли пользователю возможность проверить документ перед печатью или процесс должен быть полностью автоматическим.

Работа с параметрами и заполнение полей макета

Самая сложная часть реализации — это корректное заполнение макета данными. Параметры могут быть простыми (строка, число, дата) и составными (табличные части, списки значений). Для передачи списка товаров в печатную форму часто используется объект ТаблицаЗначений или непосредственно табличная часть документа.

Если в макете используется область с именем "Товары", которая повторяется для каждой строки номенклатуры, необходимо использовать цикл или метод Вывести() с передачей коллекции данных. Платформа 1С 8.3 автоматически размножит область макета на количество строк в переданной таблице. Это мощный инструмент, который избавляет от необходимости вручную управлять курсором в табличном документе.

При работе со сложными типами данных, такими как ХранилищеЗначения или картинки, убедитесь, что макет поддерживает вывод графических объектов. Изображения логотипов компаний или подписей ответственных лиц часто требуют предварительной конвертации в формат, понятный табличному документу.

Тип параметра	Способ передачи	Особенности вывода
Строка / Число	Структура	Прямая подстановка в поле
Дата	Структура	Требует форматирования (форматная строка)
Список товаров	ТаблицаЗначений	Автоматическое размножение области макета
Картинка	ДвоичныеДанные	Нужно поле типа "Картинка" в макете

⚠️ Внимание: Если вы передаете в макет дату, обязательно используйте форматную строку (например, ДФ="dd.MM.yyyy"), иначе дата может отобразиться в американском формате или в виде числа, что недопустимо для официальных документов.

Прямая печать и выбор принтера пользователем

Когда документ сформирован, встает вопрос о его физическом выводе. Метод Печать() объекта ТабличныйДокумент вызывает стандартное окно выбора принтера операционной системы. Это позволяет пользователю выбрать конкретное устройство, настроить количество копий и диапазон страниц.

Иногда требуется печать без диалоговых окон, например, при автоматической печати этикеток на складе. В таком случае можно использовать объект Принтер и метод УстановитьПринтерПоУмолчанию(), но это требует осторожности, так как меняет системные настройки клиента 1С. Более безопасный вариант — программно выбрать принтер из списка доступных и передать его имя в метод печати.

Не забывайте обрабатывать ситуации, когда печать не удалась. Пользователь мог отменить операцию в системном диалоге, или принтер мог быть выключен. Обработка исключений через конструкцию Попытка...Исключение позволит вывести понятное сообщение пользователю вместо технического сбоя.

Как узнать имя принтера программно?

Используйте объект Printers. Пример кода: Принтеры = Новые Принтеры(); Для каждого Принтер Из Принтеры Цикл Сообщить(Принтер.Имя); КонецЦикла;

Отладка и обработка возможных ошибок

Разработка печатных форм редко обходится без ошибок. Самые частые проблемы связаны с несовпадением имен параметров в коде и в макете, а также с форматами данных. Если поле в макете осталось пустым, проверьте регистр букв в имени параметра — платформа чувствительна к этому в некоторых контекстах.

Для отладки удобно использовать метод Показать() перед реальной печатью. Это позволяет визуально оценить результат и быстро внести правки в макет. Также полезно выводить сообщения в журнал регистрации или использовать отладчик для проверки значений переменных в момент формирования структуры параметров.

Если вы работаете в клиент-серверном варианте, помните, что печать выполняется на стороне клиента (тонкого клиента). Макеты хранятся на сервере, но рендеринг происходит локально. Это значит, что пути к файлам или ресурсы должны быть доступны машине пользователя, а не серверу баз данных.

Можно ли сделать кнопку печати видимой только для определенной роли?

Да, это стандартная практика. В свойствах кнопки на форме есть поле "Доступность". Вы можете написать функцию в модуле формы, которая возвращает Истина или Ложь в зависимости от текущей роли пользователя (например, Роль.МенеджерПоПродажам), и привязать эту функцию к свойству доступности.

Почему при печати теряется форматирование шрифта?

Чаще всего это происходит из-за того, что в макете не задан конкретный шрифт, и используется шрифт по умолчанию системы, который отличается на разных компьютерах. Явно укажите гарнитуру (например, Arial или Times New Roman) и размер шрифта в свойствах ячеек табличного документа в конфигураторе.

Как распечатать несколько документов списком одним кликом?

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

Можно ли сохранить печатную форму в файл PDF автоматически?

Да, объект ТабличныйДокумент имеет метод Записать(), который позволяет сохранить документ в различные форматы, включая PDF, MXL, TXT. Вы можете программно сформировать путь к файлу (например, на рабочем столе) и сохранить туда результат печати без участия пользователя.

Влияет ли версия платформы 1С на работу кнопки печати?

Базовые принципы работы с макетами не меняются давно, но новые версии платформы добавляют возможности, например, улучшенную работу с векторной графикой или новые форматы экспорта. Рекомендуется проверять совместимость макетов при переходе на мажорные релизы платформы, такие как переход с 8.3.10 на 8.3.20.