Используется для доступа к колонтитулам табличного документа. Колонтитул является специальным текстом, выводимым вверху или внизу каждой страницы при выводе документа на печать. В тексте колонтитула можно использовать следующие управляющие конструкции: [&НомерСтраницы] ([&PageNumber]) - при печати в данном месте будет выведен номер страницы; [&СтраницВсего] ([&PagesTotal]) - при печати в данном месте будет выведено общее количество страниц; [&Дата] ([&Date]) - при печати в данном месте будет выведена текущая дата; [&Время] ([&Time]) - при печати в данном месте будет выведено текущее время.
Полное описание, параметры и ограничения
КолонтитулТабличногоДокумента (SpreadsheetDocumentHeaderFooter)
КолонтитулТабличногоДокумента (SpreadsheetDocumentHeaderFooter)
Доступен, начиная с версии 8.2.
Свойства:
ВертикальноеПоложение (VerticalAlign)
Выводить (Enabled)
НачальнаяСтраница (StartPage)
ТекстВЦентре (CenterText)
ТекстСлева (LeftText)
ТекстСправа (RightText)
Шрифт (Font)
Описание:
Используется для доступа к колонтитулам табличного документа. Колонтитул является специальным текстом, выводимым вверху или внизу каждой страницы при выводе документа на печать. В тексте колонтитула можно использовать следующие управляющие конструкции:
[&НомерСтраницы] ([&PageNumber]) - при печати в данном месте будет выведен номер страницы;
[&СтраницВсего] ([&PagesTotal]) - при печати в данном месте будет выведено общее количество страниц;
[&Дата] ([&Date]) - при печати в данном месте будет выведена текущая дата;
[&Время] ([&Time]) - при печати в данном месте будет выведено текущее время.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
См. также:
ТабличныйДокумент, свойство ВерхнийКолонтитул
ТабличныйДокумент, свойство НижнийКолонтитул
ТабличныйДокумент, свойство РазмерКолонтитулаСверху
ТабличныйДокумент, свойство РазмерКолонтитулаСнизу
КолонтитулТабличногоДокумента, свойство ТекстВЦентре
КолонтитулТабличногоДокумента, свойство ТекстСправа
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Измерить содержимое колонтитулов и выделить им место
Размер содержимого верхнего/нижнего колонтитула — не размер поля принтера. Измеряем собственный текст и задаём запас 2 мм.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = УчебнаяТаблица();
ТабДок.ВерхнийКолонтитул.Выводить = Истина;
ТабДок.ВерхнийКолонтитул.ТекстВЦентре = "Учебный перечень товаров";
ТабДок.ВерхнийКолонтитул.Шрифт = Новый Шрифт("Arial", 10);
ТабДок.НижнийКолонтитул.Выводить = Истина;
ТабДок.НижнийКолонтитул.ТекстВЦентре = "Данные только в памяти";
ТабДок.НижнийКолонтитул.Шрифт = Новый Шрифт("Arial", 9);
ВысотаШапки = ТабДок.РассчитатьРазмерКолонтитулаСверху();
ВысотаПодвала = ТабДок.РассчитатьРазмерКолонтитулаСнизу();
ТабДок.РазмерКолонтитулаСверху = ВысотаШапки + 2;
ТабДок.РазмерКолонтитулаСнизу = ВысотаПодвала + 2;
Сообщить(ТипЗнч(ВысотаШапки) = Тип("Число"));
Сообщить(ТипЗнч(ВысотаПодвала) = Тип("Число"));
Сообщить(ТабДок.РазмерКолонтитулаСверху >= 2);
Сообщить(ТабДок.РазмерКолонтитулаСнизу >= 2);
Возврат ТабДок;
КонецФункции
&НаСервереБезКонтекста
Функция УчебнаяТаблица()
ТабДок = Новый ТабличныйДокумент;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.ОтображатьСетку = Ложь;
ТабДок.Область(, 1, , 1).ШиринаКолонки = 35;
ТабДок.Область(, 2, , 2).ШиринаКолонки = 10;
ТабДок.Область(, 3, , 3).ШиринаКолонки = 14;
ТабДок.Область(, 4, , 4).ШиринаКолонки = 15;
Заголовок = ТабДок.Область(1, 1, 1, 4);
Заголовок.Объединить();
Заголовок.Текст = "Учебная таблица — данные только в памяти";
Заголовок.Шрифт = Новый Шрифт("Arial", 12, Истина);
Заголовок.ЦветФона = Новый Цвет(230, 242, 255);
Заголовок.ВысотаСтроки = 24;
ТабДок.Область(2, 1).Текст = "Товар";
ТабДок.Область(2, 2).Текст = "Количество";
ТабДок.Область(2, 3).Текст = "Цена";
ТабДок.Область(2, 4).Текст = "Сумма";
Товары = Новый Массив;
Товары.Добавить(Новый Структура("Название,Количество,Цена", "Книга", 3, 250));
Товары.Добавить(Новый Структура("Название,Количество,Цена", "Ручка", 1, 50));
НомерСтроки = 3;
Итого = 0;
Для Каждого Товар Из Товары Цикл
ТабДок.Область(НомерСтроки, 1).Текст = Товар.Название;
Значения = Новый Массив;
Значения.Добавить(Товар.Количество);
Значения.Добавить(Товар.Цена);
Значения.Добавить(Товар.Количество * Товар.Цена);
Для НомерКолонки = 2 По 4 Цикл
Ячейка = ТабДок.Область(НомерСтроки, НомерКолонки);
Ячейка.СодержитЗначение = Истина;
Ячейка.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
Ячейка.Значение = Значения.Получить(НомерКолонки - 2);
Ячейка.Формат = "ЧДЦ=2; ЧН=0";
КонецЦикла;
Итого = Итого + Товар.Количество * Товар.Цена;
НомерСтроки = НомерСтроки + 1;
КонецЦикла;
ПодписьИтога = ТабДок.Область(5, 1, 5, 3);
ПодписьИтога.Объединить();
ПодписьИтога.Текст = "Итого";
Итог = ТабДок.Область(5, 4);
Итог.СодержитЗначение = Истина;
Итог.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
Итог.Значение = Итого;
Итог.Формат = "ЧДЦ=2; ЧН=0";
Все = ТабДок.Область(2, 1, 5, 4);
Все.Шрифт = Новый Шрифт("Arial", 10);
Граница = Новый Линия(ТипЛинииЯчейкиТабличногоДокумента.Сплошная, 1, Ложь);
Все.Обвести(Граница, Граница, Граница, Граница);
Возврат ТабДок;
КонецФункции
Разбор по шагам
Сначала задаём вывод, текст и шрифт каждого колонтитула. Затем рассчитываем размер его содержимого в миллиметрах.
Выделенный размер = рассчитанное содержимое + запас 2 мм. Не используем эти значения как аппаратную непечатную область принтера.
Конкретные измерения зависят от шрифта/платформы. Поэтому проверки не требуют фиксированного числа миллиметров.
Как проверить результат
Четыре проверки дают Истина.
В предварительном просмотре проверьте учебную надпись сверху и Данные только в памяти снизу. Печать не запускайте.
Ожидаемый результат
Раздельная настройка размеров двух колонтитулов без выдуманных постоянных метрик.
На что обратить внимание
Отсутствующий шрифт может заменяться, меняя измерение.
Колонтитул — область страницы, не первая/последняя строка таблицы; их нельзя путать при расчёте высоты данных.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Настроить страницы и колонтитулы, не вызывая принтер
Учебная таблица получает A4, поля 10 мм, шапку на каждой печатной странице и верхний/нижний колонтитулы. Это подготовка, не фактическая печать.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь приведённый модуль на уровне модуля формы: обработчик команды и функцию УчебнаяТаблица. Никакие макеты или реквизиты конфигурации не требуются.
Сохраните EPF и откройте в тонком клиенте Windows. Примеры показывают таблицу, но не вызывают принтер, не записывают файлы и не читают рабочие документы.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = УчебнаяТаблица();
ТабДок.РазмерСтраницы = "A4";
ТабДок.ОриентацияСтраницы = ОриентацияСтраницы.Портрет;
ТабДок.АвтоМасштаб = Ложь;
ТабДок.МасштабПечати = 100;
ТабДок.ПолеСлева = 10;
ТабДок.ПолеСправа = 10;
ТабДок.ПолеСверху = 10;
ТабДок.ПолеСнизу = 10;
ТабДок.НомерПервойСтраницы = 1;
ТабДок.КоличествоЭкземпляров = 1;
ТабДок.РазборПоКопиям = Истина;
ТабДок.ЧерноБелаяПечать = Ложь;
ТабДок.ЧерноБелыйПросмотр = Ложь;
ТабДок.ОбластьПечати = ТабДок.Область(1, 1, 5, 4);
ТабДок.ПовторятьПриПечатиСтроки = ТабДок.Область(2, , 2, );
Верх = ТабДок.ВерхнийКолонтитул;
Верх.Выводить = Истина;
Верх.НачальнаяСтраница = 1;
Верх.ТекстСлева = "Учебный образец";
Верх.ТекстВЦентре = "Таблица, не документ учёта";
Верх.ТекстСправа = "15.09.2026";
Верх.Шрифт = Новый Шрифт("Arial", 9);
Верх.ВертикальноеПоложение = ВертикальноеПоложение.Центр;
Низ = ТабДок.НижнийКолонтитул;
Низ.Выводить = Истина;
Низ.НачальнаяСтраница = 1;
Низ.ТекстВЦентре = "Только вымышленные товары";
Низ.Шрифт = Новый Шрифт("Arial", 9);
Сообщить(ТабДок.КоличествоЭкземпляров = 1);
Сообщить(Верх.НачальнаяСтраница = 1);
Сообщить("Принтер не вызван; параметры относятся к собственному ТабличномуДокументу.");
ТабДок.Показать("Учебная таблица — без печати и сохранения");
КонецПроцедуры
&НаКлиенте
Функция УчебнаяТаблица()
ТабДок = Новый ТабличныйДокумент;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.ОтображатьСетку = Ложь;
ТабДок.Область(, 1, , 1).ШиринаКолонки = 35;
ТабДок.Область(, 2, , 2).ШиринаКолонки = 10;
ТабДок.Область(, 3, , 3).ШиринаКолонки = 14;
ТабДок.Область(, 4, , 4).ШиринаКолонки = 15;
Заголовок = ТабДок.Область(1, 1, 1, 4);
Заголовок.Объединить();
Заголовок.Текст = "Учебная таблица — данные только в памяти";
Заголовок.Шрифт = Новый Шрифт("Arial", 12, Истина);
Заголовок.ЦветФона = Новый Цвет(230, 242, 255);
Заголовок.ВысотаСтроки = 24;
ТабДок.Область(2, 1).Текст = "Товар";
ТабДок.Область(2, 2).Текст = "Количество";
ТабДок.Область(2, 3).Текст = "Цена";
ТабДок.Область(2, 4).Текст = "Сумма";
Товары = Новый Массив;
Товары.Добавить(Новый Структура("Название,Количество,Цена", "Книга", 3, 250));
Товары.Добавить(Новый Структура("Название,Количество,Цена", "Ручка", 1, 50));
НомерСтроки = 3;
Итого = 0;
Для Каждого Товар Из Товары Цикл
ТабДок.Область(НомерСтроки, 1).Текст = Товар.Название;
Значения = Новый Массив;
Значения.Добавить(Товар.Количество);
Значения.Добавить(Товар.Цена);
Значения.Добавить(Товар.Количество * Товар.Цена);
Для НомерКолонки = 2 По 4 Цикл
Ячейка = ТабДок.Область(НомерСтроки, НомерКолонки);
Ячейка.СодержитЗначение = Истина;
Ячейка.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
Ячейка.Значение = Значения.Получить(НомерКолонки - 2);
Ячейка.Формат = "ЧДЦ=2; ЧН=0";
КонецЦикла;
Итого = Итого + Товар.Количество * Товар.Цена;
НомерСтроки = НомерСтроки + 1;
КонецЦикла;
ПодписьИтога = ТабДок.Область(5, 1, 5, 3);
ПодписьИтога.Объединить();
ПодписьИтога.Текст = "Итого";
Итог = ТабДок.Область(5, 4);
Итог.СодержитЗначение = Истина;
Итог.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
Итог.Значение = Итого;
Итог.Формат = "ЧДЦ=2; ЧН=0";
Все = ТабДок.Область(2, 1, 5, 4);
Все.Шрифт = Новый Шрифт("Arial", 10);
Граница = Новый Линия(ТипЛинииЯчейкиТабличногоДокумента.Сплошная, 1, Ложь);
Все.Обвести(Граница, Граница, Граница, Граница);
Возврат ТабДок;
КонецФункции
Разбор по шагам
РазмерСтраницы A4 и ОриентацияСтраницы Портрет задают учебный бумажный формат.
АвтоМасштаб Ложь оставляет ручной МасштабПечати 100. Поля задаются в миллиметрах.
ОбластьПечати ограничена своими пятью строками; повторяемая шапка — полная строка 2.
Колонтитулы выводятся начиная с первой страницы. Тексты полностью учебные, без данных организации.
Показать открывает табличный документ. В этом коде нет Напечатать, физической печати или сохранения файла.
Как проверить результат
Две проверки Истина.
В просмотре параметров собственного документа формат A4, портрет, масштаб 100 и поля по 10 мм.
Установлены учебные колонтитулы; нет задания в очереди печати от выполнения этого кода.
Ожидаемый результат
Новичок отделяет подготовку печатной страницы от вызова принтера.
На что обратить внимание
Количество страниц и доступная область зависят также от установленного драйвера принтера/шрифтов; этот пример их не подтверждает.
ФиксацияСверху на экране не заменяет ПовторятьПриПечатиСтроки.
Название A4 и поля могут быть ограничены конкретным драйвером при реальной печати.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.