PageColor Свойство

Цвет фона, который рисуется под отрендеренной PDF-страницей, отдельно от Color окружающего элемента управления. По умолчанию это clWhite, поэтому PDF-страницы остаются белыми как бумага даже когда Color у хост-элемента оформлен в тёмной теме

До v1.18.0 отрисованная страница PDF использовала свойство Color компонента TPdfView в качестве фона. Это было неудобно для приложений в тёмной теме: установка Color := clBlack для встраивания просмотрщика в тёмный интерфейс также закрашивала PDF-страницы чёрным фоном, из-за чего любой документ с прозрачными областями выглядел неправильно

PageColor разделяет эти две поверхности:

• Color — фон области прокрутки, закрашиваемый в зазоре между прямоугольником страницы и границей элемента управления. Оформляется основным приложением
• PageColor — фон страницы PDF, закрашиваемый внутри прямоугольника страницы позади любого отрисованного содержимого. По умолчанию clWhite

Значение clWhite по умолчанию означает, что PDF-страницы отрисовываются бумажно-белыми независимо от темы основного приложения — в соответствии с тем, как выглядят страницы в других просмотрщиках PDF. Приложения, которые ранее задавали TPdfView.Color, чтобы перекрасить страницу PDF, теперь должны задавать PageColor; новое значение по умолчанию строго улучшает типичный сценарий

• Слой отрисовки страницы рисует поверх PageColor — страница с непрозрачным содержимым показывает это содержимое; страница с прозрачными областями показывает сквозь них PageColor
• Сочетайте PageColor со свойствами PageShadowSize / PageShadowColor / PageBorderColor для классического вида «белая страница на тёмном холсте с падающей тенью»
• PageColor имеет тип TColor — альфа-канал неявно равен ($FF). Для полупрозрачных оверлеев используйте собственный обработчик отрисовки

Color, PageShadowColor, PageShadowSize, PageBorderColor