PDFium Delphi Component 文件

LoadingColor 屬性

元件: TPdfView  ·  單元: PDFium
當頁面仍在轉譯中時,檢視器會顯示一個「loading」佔位區塊,LoadingColor 就是這個區塊的填色

Syntax

property LoadingColor: TColor; // default clYellow

Description

當 AsyncRendering 為 True 時,檢視器會在實際頁面點陣圖仍在產生期間,於可見頁面中央繪製一個佔位矩形。LoadingColor 控制該矩形的背景。預設的 clYellow 與典型的白色頁面點陣圖形成高對比,即使頁面已開始在其後方繪製,指示器仍清晰可見

只有在 LoadingText 非空時才會繪製該佔位區塊 — 文字決定了矩形的大小。將 LoadingText 設為空字串會完全停用此疊加層,無論 LoadingColor 為何

在執行階段變更 LoadingColor 會於下一個繪製週期生效。此顏色不會影響實際轉譯的 PDF 內容,只影響載入指示器

Remarks

Example

// Enable an Adobe-style loading badge in the center of the page.
PdfView1.AsyncRendering := True;
PdfView1.LoadingColor := $00E0E0E0; // light gray
PdfView1.LoadingText := 'Rendering page...';

// Switch to a high-contrast badge for accessibility-mode UI.
if AccessibilityHighContrast then
begin
  PdfView1.LoadingColor := clBlack;
  PdfView1.Font.Color := clYellow;
end;

See Also

LoadingText, AsyncRendering, PageColor, Color