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

 

app.py

 

from stimulsoft_reports.viewer import StiViewer

from stimulsoft_reports.viewer.enums import StiViewerTheme

 

viewer = StiViewer()

viewer.options.appearance.theme = StiViewerTheme.OFFICE_2022_DARKGRAY_BLUE

 

 

 

На данный момент доступно 8 тем оформления c различными цветовыми акцентами. В результате, доступно более 60 вариантов оформления. Это позволяет настроить внешний вид вьювера практически под любое оформление Web-проекта.

 

Дополнительные настройки

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

 

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

Описание

StiToolbarDisplayMode.SIMPLE

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

StiToolbarDisplayMode.SEPARATED

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

 

app.py

 

from stimulsoft_reports.viewer import StiViewer

 

viewer = StiViewer()

viewer.options.toolbar.displayMode = StiToolbarDisplayMode.SIMPLE

viewer.options.appearance.scrollbarsMode = True

 

 

 

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

 

app.py

 

from stimulsoft_reports.viewer import StiViewer

 

viewer = StiViewer()

 

viewer.options.appearance.backgroundColor = 'white'

viewer.options.appearance.pageBorderColor = 'gray'

viewer.options.appearance.showPageShadow = False

 

viewer.options.toolbar.backgroundColor = 'transparent';

viewer.options.toolbar.borderColor = 'transparent';

viewer.options.toolbar.fontColor = 'transparent';

viewer.options.toolbar.fontFamily = 'Arial';

 

 

 

В качестве значения для цвета указывается одна из стандартных констант для HTML цветов, либо код цвета в RGB формате, например '#ff2020'.