PageColor Свойство

Эта запись API сохраняет идентификаторы, сигнатуры, блоки кода и термины PDF в исходном виде.

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

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

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

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

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

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

Color, PageShadowColor, PageShadowSize, PageBorderColor