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

 

Полосы прокрутки

Во вьювере предусмотрено два режима отображения отчета: с полосами прокрутки и без них. По умолчанию установлен режим просмотра без полос прокрутки. Для включения режима просмотра с полосами прокрутки достаточно установить значение True для свойства scrollbarsMode.

 

app.py

 

from stimulsoft_reports.viewer import StiViewer

 

viewer = StiViewer()

viewer.options.appearance.scrollbarsMode = True

 

 

 

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

 

Информация

 

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

 

 

 

Полноэкранный режим

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

 

app.py

 

from stimulsoft_reports.viewer import StiViewer

 

viewer = StiViewer()

viewer.options.appearance.fullScreenMode = True

 

 

 

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

 

 

Отображение страниц отчета

Во вьювере доступно три режима отображения отчета:

постраничное отображение;
отчет целиком в виде лент;
табличное отображение страниц отчета.

 

Для управления режимами предназначено свойство viewMode, которое соответственно принимает одно из указанных значений:

 

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

Описание

StiWebViewMode.SINGLE_PAGE

Отображается одна страница, выбранная на панели инструментов.

StiWebViewMode.CONTINUOUS

Отображаются все страницы отчета в виде ленты.

StiWebViewMode.MULTIPLE_PAGES

Отображаются все страницы отчета в виде таблицы.

 

 

Например, требуется установить режим отображения всех страниц в виде ленты:

 

app.py

 

from stimulsoft_reports.viewer import StiViewer

from stimulsoft_reports.viewer.enums import StiWebViewMode

 

viewer = StiViewer()

viewer.options.toolbar.viewMode = StiWebViewMode.CONTINUOUS

 

 

 

Мобильный режим

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

 

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

Описание

StiInterfaceType.AUTO

Тип интерфейса вьювера будет выбран автоматически в зависимости от используемого устройства (значение по умолчанию).

StiInterfaceType.MOUSE

Принудительное использование стандартного интерфейса для управления вьювером при помощи мыши.

StiInterfaceType.TOUCH

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

StiInterfaceType.MOBILE

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

 

 

Например, требуется полностью отключить мобильный режим отображения:

 

app.py

 

from stimulsoft_reports.viewer import StiViewer

from stimulsoft_reports.viewer.enums import StiInterfaceType

 

viewer = StiViewer()

viewer.options.appearance.interfaceType = StiInterfaceType.MOUSE