ТабличныйДокумент.ОбластьПечати

Свойства · PrintArea

Тип: ОбластьЯчеекТабличногоДокумента. Содержит область табличного документа, которая будет выводиться на печать.

Полное описание, параметры и ограничения

ТабличныйДокумент.ОбластьПечати (SpreadsheetDocument.PrintArea)

ТабличныйДокумент (SpreadsheetDocument)

ОбластьПечати (PrintArea)

Доступен, начиная с версии 8.0.

Использование:
Чтение и запись.
Описание:
Тип: ОбластьЯчеекТабличногоДокумента.
Содержит область табличного документа, которая будет выводиться на печать.
Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Примечание:
Если не задано, то будет выведена область, ограниченная значениями свойств ВысотаТаблицы и ШиринаТаблицы.
Если ВысотаТаблицы=0 и ШиринаТаблицы=0, то будет выдано сообщение "Нет информации для вывода на печать".
Если содержит прямоугольную область, то будет выведена она.
Если содержит область колонок, то будет выведена эта область, ограниченная снизу значением ВысотаТаблицы.
Если содержит область строк, то будет выведена эта область, ограниченная справа значением ШиринаТаблицы.
Использование в версии:

Доступен, начиная с версии 8.0.

Методическая информация

Практические примеры

Настроить страницы и колонтитулы, не вызывая принтер

Учебная таблица получает A4, поля 10 мм, шапку на каждой печатной странице и верхний/нижний колонтитулы. Это подготовка, не фактическая печать.

Где и как запускать

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

Подготовка

  1. Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.

  2. На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).

  3. Вставьте весь приведённый модуль на уровне модуля формы: обработчик команды и функцию УчебнаяТаблица. Никакие макеты или реквизиты конфигурации не требуются.

  4. Сохраните 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, Ложь);
    Все.Обвести(Граница, Граница, Граница, Граница);
    Возврат ТабДок;
КонецФункции

Разбор по шагам

  1. РазмерСтраницы A4 и ОриентацияСтраницы Портрет задают учебный бумажный формат.

  2. АвтоМасштаб Ложь оставляет ручной МасштабПечати 100. Поля задаются в миллиметрах.

  3. ОбластьПечати ограничена своими пятью строками; повторяемая шапка — полная строка 2.

  4. Колонтитулы выводятся начиная с первой страницы. Тексты полностью учебные, без данных организации.

  5. Показать открывает табличный документ. В этом коде нет Напечатать, физической печати или сохранения файла.

Как проверить результат

  1. Две проверки Истина.

  2. В просмотре параметров собственного документа формат A4, портрет, масштаб 100 и поля по 10 мм.

  3. Установлены учебные колонтитулы; нет задания в очереди печати от выполнения этого кода.

Ожидаемый результат

Новичок отделяет подготовку печатной страницы от вызова принтера.

На что обратить внимание

  1. Количество страниц и доступная область зависят также от установленного драйвера принтера/шрифтов; этот пример их не подтверждает.

  2. ФиксацияСверху на экране не заменяет ПовторятьПриПечатиСтроки.

  3. Название A4 и поля могут быть ограничены конкретным драйвером при реальной печати.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.