Как убрать или настроить колонтитулы при формировании табличного документа в 1С?

При выводе печатных форм и сохранении документов в 1С часто возникает необходимость отключить стандартные верхние и нижние колонтитулы или заменить их содержание на пользовательские данные (например, указать имя пользователя, текущую дату или время). Рассмотрим, как управлять колонтитулами программно с помощью средств платформы 1С.

Полное отключение вывода колонтитулов

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

Для отключения достаточно установить свойство Выводить в значение Ложь. Чтобы колонтитул также не занимал свободное место на листе, обнулим его размер:

ТабличныйДокумент.ВерхнийКолонтитул.Выводить = Ложь;
ТабличныйДокумент.НижнийКолонтитул.Выводить = Ложь;

ТабличныйДокумент.РазмерКолонтитулаСверху = 0;
ТабличныйДокумент.РазмерКолонтитулаСнизу = 0;

Важно: Порядок выполнения кода имеет ключевое значение. Установку параметров колонтитулов необходимо выполнять после очистки табличного документа или вывода основных областей из макета. Если задать свойства до заполнения документа, настройки из самого макета могут переопределить программные значения.

Программное заполнение и форматирование колонтитулов

Если колонтитулы необходимы, но нужно изменить их текст, положение или шрифт, разберем по шагам доступные свойства объекта:

1. Управление текстом: Текст в колонтитулах разделен на три секции — слева, по центру и справа. Выполняем заполнение с помощью свойств ТекстСлева, ТекстВЦентре и ТекстСправа. Допускается использование специальных шаблонов, таких как [&Дата], [&Время] и [&Страница].
2. Указание начальной страницы: Свойство НачальнаяСтраница позволяет задать номер страницы, начиная с которой будет выводиться колонтитул (например, чтобы не выводить его на титульном листе).
3. Настройка шрифта и размера: Зададим высоту отступа с помощью свойств РазмерКолонтитулаСверху или РазмерКолонтитулаСнизу, а также установим шрифт через объект Шрифт.

Рассмотрим пример программной настройки нижнего колонтитула:

// Включаем вывод нижнего колонтитула
ТабличныйДокумент.НижнийКолонтитул.Выводить = Истина;

// Задаем начальную страницу и положение
ТабличныйДокумент.НижнийКолонтитул.НачальнаяСтраница = 1;
ТабличныйДокумент.НижнийКолонтитул.ВертикальноеПоложение = ВертикальноеПоложение.Низ;

// Формируем текст колонтитула
ТабличныйДокумент.НижнийКолонтитул.ТекстСлева = "Сформировано автоматически";
ТабличныйДокумент.НижнийКолонтитул.ТекстВЦентре = Строка(ИмяПользователя()) + " [&Дата] - [&Время]";

// Настраиваем высоту области и шрифт
ТабличныйДокумент.РазмерКолонтитулаСнизу = 10;
ТабличныйДокумент.НижнийКолонтитул.Шрифт = Новый Шрифт(ТабличныйДокумент.НижнийКолонтитул.Шрифт, , 8);

Особенности и ограничения при сохранении в сторонние форматы

Выясним особенности работы колонтитулов при экспорте табличного документа из 1С в сторонние редакторы:

1. Форматы Excel (XLS, XLSX): Максимальная суммарная длина текста во всех секциях колонтитула при выгрузке ограничена 255 символами. Дополнительное цветовое оформление колонтитулов при экспорте не сохраняется.
2. Формат OpenOffice Calc (ODS): Графические изображения и фоновые цвета в секциях колонтитула при экспорте теряются. Если документ формируется через direct COM-соединение с OpenOffice (объект com.sun.star.ServiceManager), управление выполняется через стили страницы OpenOffice свойством HeaderIsOn и FooterIsOn.
3. Режим просмотра: Если пользователю запрещено редактирование печатной формы (установлено свойство ТолькоПросмотр = Истина), ручное изменение колонтитулов в окне просмотра будет недоступно.