PageColor - TPdfView - PDFium Delphi Component

组件: TPdfView · 单元: PDFium

绘制在渲染后的 PDF 页面下方的背景色，与外围控件的 Color 分离。默认值为 clWhite，因此即使宿主控件的 Color 采用深色主题，PDF 页面也会保持纸张般的白色

Syntax

property PageColor: TColor;

Description

在 v1.18.0 之前，渲染后的 PDF 页面使用 TPdfView 的 Color 属性作为其背景。这对深色模式应用程序来说很别扭：设置 Color := clBlack 以将查看器融入深色 UI 也会把 PDF 页面绘制在黑色背景上，使任何带透明区域的文档看起来都不对

PageColor 将这两个表面解耦：

Color — 滚动区域背景，绘制在页面矩形与控件边缘之间的间隙中。由宿主应用程序主题化
PageColor — PDF 页面背景，绘制在页面矩形内部、任何渲染内容之后。默认为 clWhite

默认的 clWhite 意味着 PDF 页面渲染为纸张白色，无论宿主应用程序的主题如何 — 匹配其他每个 PDF 阅读器给出的外观。先前设置 TPdfView.Color 以给 PDF 页面重新着色的应用程序应改为设置 PageColor；新默认值对常见情况来说是严格改进

Remarks

页面渲染层绘制在 PageColor 之上 — 带不透明内容的页面显示该内容；带透明区域的页面透过它们显示 PageColor
将 PageColor 与 PageShadowSize / PageShadowColor / PageBorderColor 结合，获得经典的"深色画布上带投影的白色页面"外观
PageColor 是 TColor — alpha 是隐式的（$FF）。对于半透明覆盖层，改用自定义绘制处理器

Example

// 深色模式查看器模式：深色滚动区域，纸张白色 PDF 页面
PdfView1.Color := clBlack;
PdfView1.PageColor := clWhite;

// 复古色调的阅读器背景
PdfView1.PageColor := $00C8E3F4; // BGR — 柔和琥珀色

// 恢复 v1.18.0 之前 Color 设置页面背景的行为
PdfView1.PageColor := PdfView1.Color;

PageColor 属性

组件: TPdfView · 单元: PDFium

Syntax

Description

Remarks

Example

See Also