Режимы отображения
Вьювер позволяет настраивать различные режимы отображения интерфейса и страниц отчета, а также управлять отображением на мобильных устройствах.
Во вьювере предусмотрено два режима отображения отчета: с полосами прокрутки и без них. По умолчанию установлен режим просмотра без полос прокрутки. Для включения режима просмотра с полосами прокрутки достаточно установить значение 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
|