Печать отчета
Информация |
Обратите внимание, что возможность печати доступна только для отчетов, и недоступна для дашбордов.
|
В компоненте HTML5 Viewer предусмотрено несколько вариантов печати отчета. Каждый имеет свои особенности, достоинства и недостатки.
Печать в PDF (Print to PDF)
Печать будет осуществляться посредством экспортирования отчета в PDF формат. К достоинствам можно отнести большую точность расположения и печати элементов отчета по сравнению с остальными вариантами печати. Из недостатков можно упомянуть обязательное наличие установленного в браузере плагина для просмотра PDF файлов (современные браузеры имеют встроенное средство просмотра и печати PDF файлов).
Информация |
Браузеры Internet Explorer и Edge не поддерживают прямой вывод PDF контента из JavaSctipt кода, поэтому при печати как PDF будет предложено сохранить файл, и только затем его можно будет распечатать.
|
Печать с просмотром (Print with Preview)
Печать отчета будет осуществлена в отдельном всплывающем окне браузера в HTML формат. Отчет можно предварительно просмотреть, а затем отправить на принтер или скопировать в другое место в виде текста или HTML-кода. К достоинствам можно отнести кроссбраузерность при печати, отсутствие необходимости установки специальных плагинов. Недостатком является относительно невысокая точность расположения элементов отчета, обусловленная особенностями реализации HTML-форматирования.
Печать без просмотра (Print without Preview)
Печать отчета будет осуществлена непосредственно на принтер без предварительного просмотра. После выбора этого пункта меню отображается системный диалог печати. Так как печать в этом режиме осуществляется в HTML формат, то качество печати аналогично качеству печати отчета с предварительным просмотром.
Информация |
Печать отчета осуществляется с использованием встроенных методов текущего браузера, поэтому представление диалогового окна может отличаться в разных операционных системах и браузерах. Также, браузер не позволяет управлять настройками печати из JavaScript кода, поэтому требуемые настройки необходимо будет выполнить в самом диалоговом окне.
|
Настройки печати отчета
При выборе печати отчета на панели вьювера, отображается меню с выбором варианта печати. Компонент HTML5 Viewer имеет возможность принудительно установить требуемый режим печати. Для этого достаточно установить свойство printDestination в одно из указанных ниже значений из перечисления StiPrintDestination:
Компонент HTML5 Viewer имеет возможность полностью отключить печать отчета, если она не требуется. Для этого необходимо установить значение false для свойства showPrintButton.
|
Печать отчета из кода
Так же доступна печать отчета при помощи кода. Для этого можно воспользоваться специальным методом print() у объекта отчета.
viewer.html |
... var report = new Stimulsoft.Report.StiReport(); report.loadFile("SimpleList.mrt"); report.renderAsync(function(){ report.print(); }); ... |
При печати отчета есть возможность указать диапазон печати. Для этого предназначен специальный класс StiPagesRange, в качестве аргументов конструктора допустимо задать указанные ниже параметры.
Тип диапазона (доступны следующие значения Stimulsoft.Report.StiRangeType.All, Stimulsoft.Report.StiRangeType.Pages, Stimulsoft.Report.StiRangeType.CurrentPage);
Диапазон в строковом представлении (номера страниц, разделенные запятыми или через дефис);
Текущий номер страницы.
viewer.html |
... var pageRange = new Stimulsoft.Report.StiPagesRange(Stimulsoft.Report.StiRangeType.CurrentPage, "1,3-8", 5); report.print(pageRange); ... |