PageColor property

يحافظ إدخال API هذا على المعرّفات والتواقيع وكتل الكود ومصطلحات PDF بصيغتها الأصلية.

Background colour painted under the rendered PDF page, decoupled from the surrounding control's Color. Default is clWhite so PDF pages stay paper-white even when the host control's Color is themed dark.

Prior to v1.18.0 the rendered PDF page used the TPdfView's Color property as its background. That was awkward for dark-mode applications: setting Color := clBlack to blend the viewer into a dark UI also painted PDF pages on a black backdrop, which made any document with transparent regions look wrong.

PageColor decouples the two surfaces:

• Color — the scroll-area background, painted in the gap between the page rectangle and the control edge. Themed by the host application.
• PageColor — the PDF page background, painted inside the page rectangle, behind any rendered content. Defaults to clWhite.

The default clWhite means PDF pages render as paper-white regardless of the host application's theme — matching the look every other PDF reader gives. Applications that previously set TPdfView.Color to recolour the PDF page should set PageColor instead; the new default is a strict improvement for the common case.

• The page-render layer paints on top of PageColor — a page with opaque content shows that content; a page with transparent regions shows PageColor through them.
• Combine PageColor with PageShadowSize / PageShadowColor / PageBorderColor for the classic "white page on dark canvas with drop shadow" look.
• PageColor is a TColor — alpha is implicit ($FF). For semi-transparent overlays use a custom paint handler instead.

Color, PageShadowColor, PageShadowSize, PageBorderColor