Инструментальные панели для печати

Инструментальные панели для печати — это инструментальные панели, предназначенные для создания PDF-документов с пагинацией и предсказуемой компоновкой. Они предназначены для сценариев, подобных созданию отчетов, где размер страницы, границы, масштабирование, заголовки, нижние колонтитулы, а также нумерация страниц должны оставаться неизменными при визуализации.

Инструментальная панель для печати не является отдельным автономным типом контекста. Это дочерний контекст инструментальной панели внутри контейнера «Инструментальные панели». Поэтому печатная инструментальная панель наследует стандартные общедоступные переменные, функции и события инструментальной панели, а также добавляет поведение, специфичное для печати. Переменные и функции, специфичные для печати, определены в соответствующих контекстах Инструментальная панель, Инструментальные панели и Корневая панель.

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

Инструментальная панель становится доступной для печати, когда свойство printable включено в свойствах инструментальной панели. Когда printable свойство включено, инструментальная панель инициализируется как компоновка для печати с специфической для печати конфигурацией.

Структура инструментальной панели для печати

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

Размер полос можно изменять только по вертикали; их ширина ограничена размером печатной страницы и границами. Порядок полос нельзя изменять. Некоторые типы полос, такие как «Подробности», могут иметь несколько экземпляров, но они всегда остаются в своем заданном месте в структуре страницы.

По умолчанию печатные полосы используются следующим образом.

Полоса

Описание

title

Область заголовка отчета

pageHeader

Заголовок, отображаемый в верхней части каждой страницы

single

Область основного содержимого

pageFooter

Нижний колонтитул, отображаемый на каждой странице

lastPageFooter

Нижний колонтитул, отображаемый на последней странице

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

Типы дополнительных печатных полос приведены ниже.

Полоса

Описание

Верхний колонтитул столбца

Отображает содержимое в верхней части каждой колонки на каждой странице.

Верхний колонтитул группы

Отображает содержимое в начале каждой группы данных.

Нижний колонтитул группы

Отображает содержимое в конце каждой группы данных.

Нижний колонтитул столбца

Отображает содержимое внизу каждого столбца на каждой странице.

Сводка

Отображает итоговые агрегированные или сводные данные после всех данных.

Нет данных

Отображает содержимое, когда источник данных не содержит записей.

Поведение во время Runtime

Режим редактирования

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

Режим выполнения

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

Печать

Печать одной инструментальной панели

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

Поле

Описание

Ориентация страницы

Определяет ориентацию страницы для печати. Поддерживаемые значения:

  • Portrait

  • Landscape.

Масштаб печати

Определяет режим масштабирования для печати. Поддерживаемые значения:

  • Normal

  • Fit to Width

  • Fit to Height

  • Fit to Page

  • Custom Number.

Если Print Page Scale установлено значение Custom Number, при визуализации для печати используется дополнительное пользовательское значение масштаба в процентах.

Размер бумаги

Определяет целевой размер бумаги. Поддерживаемые значения:

  • A3

  • A4

  • A5

  • Custom.

Верхняя граница

Integer. Определяет верхнюю границу страницы.

Нижняя граница

Integer. Определяет нижнее поле страницы.

Левая граница

Integer. Определяет левую границу страницы.

Правая граница

Целое число. Определяет правое поле страницы.

Контекст по умолчанию

Определяет контекст по умолчанию, используемый при рендеринге для печати. Значение: значение контекста или NULL.

Пользовательские свойства

Data Table. Предоставляет дополнительные свойства для печати. Значением является таблица с полями property и value.

Режим вывода

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

  • Print

  • Download.

Print отправляет сгенерированный документ на печать. Download возвращает сгенерированный PDF-файл в виде файла для скачивания.

Печать нескольких инструментальных панелей

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

Для каждой инструментальной панели, включенной в вывод, укажите следующие настройки:
ее путь к контексту, настройки печати и, при необходимости, номер начальной страницы в объединенном документе.

Поле

Описание

reportPath

Определяет путь к контексту панели инструментов, которую необходимо включить в объединенный вывод.

params

Определяет настройки печати для инструментальной панели. Использует ту же структуру параметров, что и при печати одной инструментальной панели.

firstPage

Определяет необязательный номер начальной страницы инструментальной панели в объединенном документе.

Was this page helpful?