PageColor - TPdfView - PDFium Delphi Component

元件: TPdfView · 單元: PDFium

繪製在 PDF 頁面下方的背景色，與周邊控制項的 Color 分離。預設為 clWhite，因此即使宿主控制項採用深色主題，PDF 頁面仍會維持紙張般的白色

Syntax

property PageColor: TColor;

Description

在 v1.18.0 之前，算繪後的 PDF 頁面使用 TPdfView 的 Color 屬性作為背景。這對深色模式的應用程式並不方便：為了讓檢視器融入深色 UI 而設定 Color := clBlack 時， 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

// Dark-mode viewer pattern: dark scroll area, paper-white PDF page
PdfView1.Color := clBlack;
PdfView1.PageColor := clWhite;

// Sepia-tinted reader background
PdfView1.PageColor := $00C8E3F4; // BGR — soft amber

// Restore pre-v1.18.0 behavior where Color sets the page background
PdfView1.PageColor := PdfView1.Color;

PageColor 屬性

元件: TPdfView · 單元: PDFium

Syntax

Description

Remarks

Example

See Also