В процессе разработки печатных форм в среде «1С:Предприятие 8» программисты часто сталкиваются с коварной проблемой: свойство табличного документа ПовторятьПриПечатиСтроки отлично отрабатывает в режиме предварительного просмотра, но при нажатии на кнопку «Печать» (напрямую на принтер) заголовок таблицы на второй и последующих страницах упорно не выводится. Ситуация кажется мистической, ведь код один и тот же, и в предварительном просмотре всё выглядит идеально.
В этой статье мы подробно разберем внутренние механизмы платформы «1С» и Библиотеки стандартных подсистем (БСП), выясним истинные причины этой проблемы и пошагово исправим код, сделав вывод сквозной шапки таблицы надежным и стабильным в любом режиме печати.
Для того чтобы решить проблему раз и навсегда, нам необходимо понять, как платформа 1С и БСП работают с табличными документами «под капотом» при разных сценариях взаимодействия с пользователем.
Рассмотрим два сценария работы системы:
ТабличныйДокумент, который вы сформировали в своем коде. Все свойства, которые вы явно присвоили этому документу (ориентация, масштаб, сквозные строки), применяются непосредственно к нему и визуализируются графическим движком платформы без изменений.УправлениеПечатью). Подсистема печати оптимизирует вывод: она берет сформированный вами документ, анализирует его области разметки, создает новый (чистый) временный табличный документ и копирует в него блоки данных для отправки на принтер.Именно в момент копирования областей БСП во временный документ происходит ключевая системная потеря: свойства табличного документа (такие как масштаб, ориентация страницы и повторение строк) не копируются автоматически вместе с ячейками. Если в коде допущена хотя бы малейшая ошибка интеграции с механизмами печати БСП, временный документ теряет признак ПовторятьПриПечатиСтроки, и принтер выдает листы без шапки таблицы.
Проанализируем типичный фрагмент кода, в котором разработчики совершают сразу несколько критических ошибок, приводящих к сбою механизма повторения строк при прямой печати.
Посмотрим на классический ошибочный фрагмент:
// ОШИБКА 1: Попытка взять область из Макета, а не из результирующего ТабДока
ТоварыОбласть = Макет.Область("ТоварыШапкаТаблицы");
ТабДок.ПовторятьПриПечатиСтроки = ТоварыОбласть;
Пока ВыборкаДетальныеЗаписи.Следующий() Цикл
// ... Вывод строк ...
ТабДок.Вывести(ТоварыОбластьДетальныхЗаписей);
// ОШИБКА 2: Вызов функции разметки БСП внутри цикла по строкам
УправлениеПечатью.ЗадатьОбластьПечатиДокумента(ТабДок, НомерСтрокиНачало, ОбъектыПечати, ВыборкаДетальныеЗаписи.Ссылка);
КонецЦикла;
// ОШИБКА 3: Ограничение сквозной области колонками
ТабДок.ПовторятьПриПечатиСтроки = ТабДок.Область("R6C1:R6C10");
Разберем детально каждую из этих ошибок, чтобы понять физику их влияния на результат.
Свойство ПовторятьПриПечатиСтроки должно содержать область ячеек, принадлежащую именно выводимому табличному документу (переменной ТабДок), а не исходному макету (переменной Макет). Назначение области макета приведет к тому, что платформа проигнорирует свойство при формировании физических страниц.
Это самая критическая ошибка интеграции с БСП. Процедура УправлениеПечатью.ЗадатьОбластьПечатиДокумента() предназначена для того, чтобы зафиксировать границы целого физического документа (например, одной накладной или одного акта) в общем пакете печати. Когда этот метод вызывается на каждую строчку внутри цикла обхода табличной части:
Адресация вида "R6C1:R6C10" указывает на конкретный диапазон колонок (с первой по десятую) внутри шестой строки. Свойство ПовторятьПриПечатиСтроки ожидает на вход исключительно целые строки без горизонтальных ограничений. Ограничение по колонкам часто игнорируется платформой при прямой генерации печатного потока.
Теперь, когда мы выяснили все причины сбоя, исправим алгоритм. Мы перепишем логику формирования печатной формы, сделав ее чистой, быстрой и полностью совместимой с БСП.
Для свойства ПовторятьПриПечатиСтроки нужно передавать область, состоящую только из строк, охватывающих всю ширину листа. Рекомендуется использовать числовой метод адресации Область(НачалоСтрок, , КонецСтрок, ).
Например, если шапка нашей таблицы находится строго на 6-й строке выводимого документа, код должен выглядеть так:
ТабДок.ПовторятьПриПечатиСтроки = ТабДок.Область(6, , 6, );
Если шапка многострочная и занимает строки с 6-й по 8-ю включительно:
ТабДок.ПовторятьПриПечатиСтроки = ТабДок.Область(6, , 8, );
Не нужно пытаться использовать метод ПроверитьВывод() для ручного добавления шапки или динамического переопределения свойства. Платформа 1С спроектирована так, чтобы автоматически рассчитывать и дублировать шапку на листах. Достаточно задать это свойство один раз после того, как строки шапки физически выведены в итоговый табличный документ.
Вызов процедуры ЗадатьОбластьПечатиДокумента должен выполняться строго один раз для одного документа. Мы должны зафиксировать строку начала вывода перед выводом шапки и заголовка, затем вывести весь документ (включая все строки табличной части в цикле), и только в самом конце вызвать процедуру БСП для фиксации готовой области печати.
Рассмотрим итоговый эталонный вариант кода, в котором учтены все правила платформы 1С и требования стандартов разработки БСП:
// Запоминаем начальную строку вывода для текущего документа
НомерСтрокиНачало = ТабДок.ВысотаТаблицы + 1;
// 1. Выводим заголовок документа
ОбластьЗаголовок = Макет.ПолучитьОбласть("Заголовок");
ОбластьЗаголовок.Параметры.Заполнить(ДанныеШапки);
ТабДок.Вывести(ОбластьЗаголовок);
// 2. Выводим шапку таблицы (запоминаем её физические строки)
ОбластьШапкаТаблицы = Макет.ПолучитьОбласть("ТоварыШапкаТаблицы");
ТабДок.Вывести(ОбластьШапкаТаблицы);
// Вычисляем номера строк шапки в результирующем документе для сквозного повторения
СтрокаНачалаШапки = ТабДок.ВысотаТаблицы; // Строка, на которой только что вывелась шапка
СтрокаКонцаШапки = ТабДок.ВысотаТаблицы; // Если шапка в одну строку, индексы совпадают
// 3. Выводим табличную часть документа в цикле
ОбластьДетали = Макет.ПолучитьОбласть("ТоварыДетали");
ВыборкаСтрок = РезультатЗапроса.Выбрать();
Пока ВыборкаСтрок.Следующий() Цикл
ОбластьДетали.Параметры.Заполнить(ВыборкаСтрок);
ТабДок.Вывести(ОбластьДетали);
КонецЦикла;
// 4. Выводим подвал документа (если требуется)
ОбластьПодвал = Макет.ПолучитьОбласть("Подвал");
ТабДок.Вывести(ОбластьПодвал);
// 5. Устанавливаем свойство повторения строк по полученным ранее координатам
// Передаем строго строки результирующего табличного документа без колонок
ТабДок.ПовторятьПриПечатиСтроки = ТабДок.Область(СтрокаНачалаШапки, , СтрокаКонцаШапки, );
// 6. Регистрируем область печати всего документа в механизме БСП (выполняется ОДИН раз для документа)
УправлениеПечатью.ЗадатьОбластьПечатиДокумента(ТабДок, НомерСтрокиНачало, ОбъектыПечати, СсылкаНаОбъект);
Для того чтобы свойство ПовторятьПриПечатиСтроки работало стабильно как на экране в режиме предварительного просмотра, так и при прямой отправке на физический принтер, всегда следуйте трем «золотым» правилам:
ТабличногоДокумента, но никогда из Макета.ТабДок.Область(Начало, , Конец, ).Соблюдение этих стандартов гарантирует предсказуемое поведение ваших печатных форм и избавит пользователей от проблем с «теряющимися» шапками таблиц на печати.