PDFium Delphi Component Docs

LoadingColor プロパティ

コンポーネント: TPdfView  ·  ユニット: PDFium
ページのレンダリング中に描画される “loading” プレースホルダーの塗りつぶし色です

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