Настройка HTML5 Viewer выполняется при помощи свойств, находящихся в классе Stimulsoft.Viewer.StiViewerOptions. Все свойства разделены на группы для удобства использования. Ниже приведен пример установки свойств вьювера:

 

viewer.html

...

<script type="text/javascript">

var report = new Stimulsoft.Report.StiReport();

report.loadFile("SimpleList.mrt");

 

var options = new Stimulsoft.Viewer.StiViewerOptions();

 

options.width = "1000px";

options.height = "1000px";

 

options.appearance.theme = Stimulsoft.Viewer.StiViewerTheme.Office2022WhiteBlue;

options.appearance.reportDisplayMode = Stimulsoft.Report.Export.StiHtmlExportMode.Auto;

options.appearance.scrollbarsMode = true;

options.appearance.backgroundColor = Stimulsoft.System.Drawing.Color.dodgerBlue;

options.appearance.showTooltips = false;

 

options.toolbar.showPrintButton = false;

options.toolbar.showDesignButton = false;

options.toolbar.showAboutButton = false;

 

options.exports.showExportToPdf = true;

options.exports.ShowExportToWord = true;

 

var viewer = new Stimulsoft.Viewer.StiViewer(options);

viewer.report = report;

</script>

...

 

 

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

 

Default.aspx.cs

...

var dbsElementInteraction = report.getComponentByName("RegionMap1").dashboardInteraction;

dbsElementInteraction.showFullScreenButton = false;

dbsElementInteraction.showSaveButton = false;

...

 

 

Главная (без группы)

 

Наименование

Описание

width

Задает ширину компонента в “px” или “%”.

height

Задает высоту компонента в “px” или “%”. Работает только в режиме если свойство options.appearance.scrollbarsMode установлено в значение true.

 

 

Оформление (Appearance)

 

Наименование

Описание

options.appearance.theme

Задает тему оформления вьювера. Список доступных тем оформления находится в перечислении StiViewerTheme. По умолчанию установлено значение Office2022WhiteBlue.

options.appearance.iconSet

Предоставляет возможность установить набор иконок:
 
strel11 Stimulsoft.Viewer.StiWebUIIconSet.Auto (значение по умолчанию) -  устанавливает набор иконок автоматически. Для тем Office2022 - используется набор иконок в стиле Monoline, для тем Office2013 - используется набор иконок в стиле Regular.

strel11 Stimulsoft.Viewer.StiWebUIIconSet.Monoline - устанавливает набор иконок в стиле Monoline;

strel11 Stimulsoft.Viewer.StiWebUIIconSet.Regular - устанавливает набор иконок в стиле Regular.

appearance.backgroundColor

Устанавливает цвет фона вьювера. По умолчанию, установлено значение Stimulsoft.System.Drawing.Color.white.

appearance.pageBorderColor

Устанавливает цвет границы страниц отчета. По умолчанию, установлено значение Stimulsoft.System.Drawing.Color.gray.

appearance.rightToLeft

Устанавливает режим отображения Right to Left для элементов управления вьювера. По умолчанию, установлено значение false

appearance.fullScreenMode

Устанавливает полноэкранный режим отображения вьювера. Если свойство установлено в значение true, то значения свойств width и height игнорируются. По умолчанию, установлено значение false.

appearance.scrollbarsMode

Устанавливает режим отображения отчета с полосами прокрутки. По умолчанию, установлено значение false.

appearance.openLinksWindow

Устанавливает целевое окно или фрэйм для открытия гиперссылок из отчета. По умолчанию, установлено значение “_blank” (новая вкладка браузера). Может принимать одно из стандартных значений "_blank", "_self", "_top", a так же имя окна либо фрэйма.

appearance.showTooltips

Включает или выключает отображение подсказок при наведении курсора на инструмент вьювера. По умолчанию, установлено значение true.

appearance.showTooltipsHelp

Предоставляет возможность отображать или не отображать ссылку на документацию в подсказках при наведении курсора на инструмент вьювера. По умолчанию, установлено значение true.

appearance.showDialogsHelp

Предоставляет возможность отображать или не отображать кнопку вызова справки в различных меню. По умолчанию, установлено значение true.

appearance.pageAlignment

Устанавливает выравнивание страниц отчета во вьювере.

 

strel11 Stimulsoft.Viewer.StiContentAlignment.Left – выравнивание страниц по левому краю;

strel11 Stimulsoft.Viewer.StiContentAlignment.Center – выравнивание страниц по центру;

strel11 Stimulsoft.Viewer.StiContentAlignment.Right – выравнивание страниц по правому краю.

 

По умолчанию, установлено значение Stimulsoft.Viewer.StiContentAlignment.Center.

appearance.showPageShadow

Включает или выключает отображение тени страниц отчета. По умолчанию, установлено значение true.

appearance.bookmarksPrint

Включает печать закладок в отчете. По умолчанию, установлено значение false.

appearance.bookmarksTreeWidth

Устанавливает ширину панели закладок в пикселях. По умолчанию, установлено значение 180.

appearance.parametersPanelMaxHeight

Устанавливает максимальную высоту панели параметров в пикселях. По умолчанию, установлено значение 300.

appearance.parametersPanelColumnsCount

Устанавливает количество колонок на панели параметров. По умолчанию, установлено значение 2.

appearance.parametersPanelSortDataItems

Устанавливает или выключает режим сортировки значений переменной. По умолчанию, опция установлена в значение true, т.е. значения переменной сортируются.

appearance.parametersPanelDateFormat

Устанавливает формат даты и времени для переменных, которые отображаются на панели параметров. По умолчанию, установлено значение String.empty.

appearance.reportDisplayMode

Устанавливает режим экспорта для отображения страниц отчета. Может принимать одно из следующих значений:

 

strel11 FromReport - режим экспорта элементов отчета определяется из настроек шаблона - Div или Table;

strel11 Table – элементы отчета экспортируются с использованием таблиц HTML (значение по умолчанию);

strel11 Div – элементы отчета экспортируются с использованием разметки DIV;

appearance.interfaceType

Устанавливает тип интерфейса вьювера. Могут использоваться следующие значения:

 

strel11 Stimulsoft.Viewer.StiInterfaceType.Auto – тип интерфейса вьювера будет выбран автоматически в зависимости от используемого устройства (значение по умолчанию);

strel11 Stimulsoft.Viewer.StiInterfaceType.Mouse – принудительное использование стандартного интерфейса для управления вьювером при помощи мыши;

strel11 Stimulsoft.Viewer.StiInterfaceType.Touch – принудительное использование Touch интерфейса для управления вьювером при помощи сенсорного экрана монитора, в этом режиме элементы интерфейса вьювера имеют увеличенные размеры для удобства управления;

strel11 Stimulsoft.Viewer.StiInterfaceType.Mobile – принудительное использование Mobile интерфейса для управления вьювером при помощи экрана смартфона, в этом режиме интерфейс вьювера имеет упрощенный вид и адаптирован для управления при помощи мобильного устройства.

 

 

По умолчанию, установлено значение Stimulsoft.Viewer. StiInterfaceType.Auto.

appearance.allowMobileMode

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

appearance.chartRenderType

Устанавливает тип отрисовки диаграмм в отчете:

 

strel11 Stimulsoft.Viewer.StiChartRenderType.AnimatedVector – диаграммы будут отрисованы в векторном режиме с анимацией;

strel11 Stimulsoft.Viewer.StiChartRenderType.Vector – диаграммы будут отрисованы как векторное изображение без анимации.

 

По умолчанию, установлено значение Stimulsoft.Viewer.StiChartRenderType.AnimatedVector.

appearance.datePickerFirstDayOfWeek

Предоставляет возможность установить первый день недели для инструмента Выбор даты (Date picker).

 

strel11 Stimulsoft.Viewer.StiFirstDayOfWeek.Auto - Будет установлен понедельник или воскресенье как первый день недели, в зависимости от культуры браузера.

strel11 Stimulsoft.Viewer.StiFirstDayOfWeek.Monday - Понедельник будет установлен как первый день недели.

strel11 Stimulsoft.Viewer.StiFirstDayOfWeek.Sunday - Воскресенье будет установлен как первый день недели.

appearance.datePickerIncludeCurrentDayForRanges

Предоставляет возможность включать или не включать текущий день в диапазон значений элемента Выбор даты (Date Picker). По умолчанию, опция установлена в значение false, т.е. текущий день не включается в диапазон значений элемента.

appearance.allowTouchZoom

Предоставляется возможность изменять масштаб вьювера касанием. По умолчанию, опция установлена в значение true.

appearance.combineReportPages

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

 

 

Панель инструментов (Toolbar)

 

Наименование

Описание

toolbar.visible

Предоставляет возможность отображать или не отображать панель инструментов вьювера. По умолчанию, установлено значение true.

toolbar.displayMode

Задает режим отображения панели инструментов вьювера. Может принимать одно из указанных ниже значений перечисления displayMode:

 

strel11 Simple – простой режим отображения, все элементы управления расположены на одной панели управления (значение по умолчанию);

strel11 Separated – раздельный режим отображения, панель управления разделена на верхнюю и нижнюю.

toolbar.backgroundColor

Предоставляет возможность изменить цвет панели инструментов. По умолчанию, установлено значение Stimulsoft.System.Drawing.Color.empty.

toolbar.borderColor

Предоставляет возможность изменить цвет границы панели инструментов. По умолчанию, установлено значение Stimulsoft.System.Drawing.Color.empty.

toolbar.fontColor

Предоставляет возможность изменить цвет шрифта для всех элементов на панели инструментов и во всех меню этой панели. По умолчанию, установлено значение Stimulsoft.System.Drawing.Color.empty.

toolbar.fontFamily

Предоставляет возможность изменить шрифт для всех элементов на панели инструментов и во всех меню этой панели. По умолчанию, установлено значение ”Arial”.

toolbar.alignment

Устанавливает выравнивание элементов на панели управления.

 

strel11 Stimulsoft.Viewer.StiContentAlignment.Default – выравнивание элементов зависит от опции RightToLeft; 

strel11 Stimulsoft.Viewer.StiContentAlignment.Left – все элементы будут выровнены по левому краю панели инструментов;

strel11 Stimulsoft.Viewer.StiContentAlignment.Center – все элементы будут выровнены по центру панели инструментов;

strel11 Stimulsoft.Viewer.StiContentAlignment.Right – все элементы будут выровнены по правой стороне панели инструментов.

 

По умолчанию, установлено значение Stimulsoft.Viewer.StiContentAlignment.Default.

toolbar.showButtonCaptions

Включает или выключает отображение текста кнопок панели инструментов вьювера. По умолчанию, установлено значение true.

toolbar.showOpenButton

Включает отображение кнопки Открыть (Open) на панели инструментов вьювера при просмотре отчетов или панели индикаторов (дашбордов). По умолчанию свойство имеет значение true.

toolbar.showPrintButton

Предоставляет возможность отображать или не отображать кнопку Печать (Print) на панели инструментов. По умолчанию, установлено значение true.

toolbar.showSaveButton

Включает отображение кнопки Сохранить (Save) на панели инструментов вьювера при просмотре отчетов или панели индикаторов (дашбордов). По умолчанию свойство имеет значение true.

toolbar.showSendEmailButton

Предоставляет возможность отображать или не отображать кнопку Отправить по Email (Send Email) на панели инструментов. По умолчанию, установлено значение false. Также, необходимо добавить обработчик события onEmailReport.

toolbar.showFindButton

Предоставляет возможность отображать или не отображать кнопку Поиск (Find) на панели инструментов. По умолчанию, установлено значение true.

toolbar.showBookmarksButton

Предоставляет возможность отображать или не отображать кнопку Закладки (Bookmarks) на панели инструментов. Если эта кнопка не отображается, то и панель закладок в отчете отображаться не будет. По умолчанию, установлено значение true.

toolbar.showParametersButton

Предоставляет возможность отображать или не отображать кнопку Параметры (Parameters) на панели инструментов. Если эта кнопка не отображается, то и панель параметров в отчете отображаться не будет. По умолчанию, установлено значение true.

toolbar.showResourcesButton

Предоставляет возможность отображать или не отображать кнопку Ресурсы (Resources) на панели инструментов. Если эта кнопка не отображается, то и панель ресурсов в отчете отображаться не будет. По умолчанию, установлено значение true.

toolbar.showEditorButton

Предоставляет возможность отображать или не отображать кнопку Редактировать (Editor) на панели инструментов. Если эта кнопка не отображается, то невозможно будет изменить редактируемые элементы. По умолчанию, установлено значение true.

toolbar.showFullScreenButton

Включает отображение кнопки Полноэкранный просмотр (Full Screen) на панели инструментов вьювера при просмотре отчетов или панели индикаторов (дашбордов). По умолчанию свойство имеет значение true.

toolbar.showRefreshButton

Предоставляет возможность отображать или не отображать кнопку Обновить (Refresh) на панели инструментов вьювера при просмотре панели индикаторов (дашбордов). По умолчанию свойство имеет значение true.

toolbar.showFirstPageButton

Предоставляет возможность отображать или не отображать кнопку Первая страница (First Page) на панели инструментов. По умолчанию, установлено значение true.

toolbar.showPreviousPageButton

Предоставляет возможность отображать или не отображать кнопку Последняя страница (Previous Page) на панели инструментов. По умолчанию, установлено значение true.

toolbar.showCurrentPageControl

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

toolbar.showNextPageButton

Предоставляет возможность отображать или не отображать кнопку Следующая страница (Next Page) на панели инструментов. По умолчанию, установлено значение true.

toolbar.showLastPageButton

Предоставляет возможность отображать или не отображать кнопку Предыдущая страница (Last Page) на панели инструментов. По умолчанию, установлено значение true.

toolbar.showZoomButton

Предоставляет возможность отображать или не отображать кнопку выбора масштаба на панели инструментов. По умолчанию, установлено значение true.

toolbar.showViewModeButton

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

toolbar.showDesignButton

Включает отображение кнопки Дизайн (Design) на панели инструментов вьювера при просмотре отчетов или панели индикаторов (дашбордов). По умолчанию свойство имеет значение false.

toolbar.showAboutButton

Предоставляет возможность отображать или не отображать кнопку О программе (About) на панели инструментов. По умолчанию, установлено значение true.

toolbar.showPinToolbarButton

Предоставляет возможность отображать или не отображать кнопку Закрепить (Pin) в мобильном режиме просмотра отчета. По умолчанию, установлено значение true.

toolbar.printDestination

Устанавливает режим печати отчета. Может принимать одно из указанных ниже значений перечисления StiPrintDestination:

 

strel11 Default – будет отображено меню с предоставлением выбора режима печати (значение по умолчанию);

strel11 Pdf – печать будет осуществлена в формате PDF;

strel11 Direct – печать будет осуществлена в формате HTML непосредственно на принтер, будет отображен системный диалог печати;

strel11 PopupWindow – печать будет осуществлена в формате HTML через всплывающее окно предварительного просмотра отчета.

toolbar.viewMode

Устанавливает режим отображения страниц отчета:

 

strel11 Stimulsoft.Viewer.StiWebViewMode.OnePage – отображается одна страница, выбранная на панели инструментов.

strel11 Stimulsoft.Viewer.StiWebViewMode.Continuous – отображаются все страницы отчета в виде ленты.

strel11 Stimulsoft.Viewer.StiWebViewMode.MultiplePages – отображаются все страницы отчета в виде таблицы.

 

По умолчанию, установлено значение Stimulsoft.Viewer.StiWebViewMode.OnePage.

toolbar.zoom()

Предоставляет возможность установить масштаб страниц отчета при загрузке вьювера. По умолчанию, 100 процентов. Максимальное значение 500 процентов.

 

strel11 Stimulsoft.Viewer.StiZoomMode.PageWidth – масштаб страниц отчета по ширине страницы.

strel11 Stimulsoft.Viewer.StiZoomMode.PageHeight – масштаб страниц отчета по высоте страницы.

 

По умолчанию, установлено значение 100 процентов.

toolbar.menuAnimation

Предоставляет возможность включить или выключить анимацию отображения и закрытия различных меню во вьювере. По умолчанию, установлено значение true.

toolbar.showMenuMode

Устанавливает режим раскрытия различных меню во вьювере - при наведении или по щелчку. По умолчанию, установлено значение Stimulsoft.Viewer.StiShowMenuMode.Click.

toolbar.autoHide

Устанавливает режим автоматического сворачивания панели инструментов при просмотре отчета в мобильном режиме. По умолчанию, установлено значение false.

 

 

Экспорт (Exports)

 

Наименование

Описание

export.storeExportSettings

Предоставляет возможность сохранять настройки экспорта в cookies. По умолчанию, установлено значение true.

exports.showExportDialog

Предоставляет возможность отображать или не отображать меню настроек экспорта. Если меню спрятано, экспорт будет выполнен со значениями по умолчанию. По умолчанию, установлено значение true.

exports.showExportToDocument

Предоставляет возможность отображать или не отображать элемент Document File в меню Сохранить (Save). По умолчанию, установлено значение true.

exports.showExportToPdf

Включает отображение пункта меню экспорта Adobe PDF файл (Adobe PDF File) при просмотре отчетов, и пункт Adobe PDF при просмотре панелей индикаторов. По умолчанию свойство имеет значение true.

exports.showExportToPowerPoint

Включает отображение пункта меню экспорта Microsoft PowerPoint 2007/2010 файл (Microsoft PowerPoint 2007/2010 File). По умолчанию свойство имеет значение true.

exports.showExportToHtml

Предоставляет возможность отображать или не отображать элемент HTML File в меню Настройки экспорта (Export Settings). По умолчанию, установлено значение true.

exports.showExportToHtml5

Предоставляет возможность отображать или не отображать элемент HTML5 File в меню Настройки экспорта (Export Settings). По умолчанию, установлено значение true.

exports.showExportToText

Включает отображение пункта меню экспорта Text файл (Text File). По умолчанию свойство имеет значение true.

exports.showExportToWord

Предоставляет возможность отображать или не отображать элемент Microsoft Word 2007/2010 File в меню Сохранить (Save). По умолчанию, установлено значение true.

exports.showExportToOpenDocumentWriter

Включает отображение пункта меню экспорта OpenDocument Writer файл (OpenDocument Writer File). По умолчанию свойство имеет значение true.

exports.showExportToExcel

Включает отображение пункта меню экспорта Microsoft Excel 2007/2010 файл (Microsoft Excel 2007/2010 File) при просмотре отчетов, и пункт Microsoft Excel при просмотре панелей индикаторов. По умолчанию свойство имеет значение true.

exports.showExportToOpenDocumentCalc

Включает отображение пункта меню экспорта OpenDocument Calc файл (OpenDocument Calc File). По умолчанию свойство имеет значение true.

exports.showExportToCsv

Включает отображение пункта меню экспорта CSV файл (CSV File). По умолчанию свойство имеет значение true.

exports.showExportToJson

Включает отображение пункта меню экспорта JSON файл (JSON File). По умолчанию свойство имеет значение false.

showExportToImageSvg

Включает отображение пункта меню экспорта Изображение (Image), с возможность экспорта отчета в SVG файл. По умолчанию свойство имеет значение true.

 

 

Отправить по Email (Email)

 

Наименование

Описание

email.showEmailDialog

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

email.showExportDialog

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

email.defaultEmailAddress

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

email.defaultEmailSubject

Устанавливает тему (заголовок) электронного письма по умолчанию. По умолчанию, значение не задано.

email.defaultEmailMessage

Устанавливает сообщение (текст) электронного письма по умолчанию. По умолчанию, значение не задано.