PageColor - TPdfView - PDFium Delphi Component

コンポーネント: TPdfView · ユニット: PDFium

描画された PDF ページの下に塗られる背景色です。周囲のコントロールの Color から分離されています。既定値は clWhite で、ホストコントロールの Color がダークテーマでも PDF ページは紙白のまま保たれます

構文

property PageColor: TColor;

説明

v1.18.0 より前は、描画された PDF ページは TPdfView の Color プロパティを背景として使用していました。これはダークモードのアプリケーションでは扱いにくい挙動でした。ビューアを暗い UI に溶け込ませるために Color := clBlack を設定すると、PDF ページも黒い下地の上に描画され、透明領域を持つドキュメントはすべて不正に見えていました

PageColor はこの 2 つのサーフェスを分離します

Color — スクロール領域の背景で、ページ矩形とコントロール端の隙間に塗られます。ホストアプリケーションのテーマに従います
PageColor — PDF ページの背景で、ページ矩形の内側、描画コンテンツの背面に塗られます。既定値は clWhite です

既定値の clWhite により、PDF ページはホストアプリケーションのテーマに関係なく紙白で描画されます — これは他のすべての PDF リーダーが見せる外観と一致します。以前は PDF ページを再着色するために TPdfView.Color を設定していたアプリケーションは、代わりに PageColor を設定してください。新しい既定値は、一般的なケースにとって明確な改善です

備考

ページ描画レイヤーは PageColor の上に塗ります — 不透明なコンテンツを持つページはそのコンテンツを表示し、透明領域を持つページはそこから PageColor を表示します
PageColor を PageShadowSize / PageShadowColor / PageBorderColor と組み合わせると、定番の「暗いキャンバスの上にドロップシャッド付きの白いページ」の外観になります
PageColor は TColor です — アルファは暗黙に $FF になります。半透明のオーバーレイには、代わりにカスタム描画ハンドラを使用してください

例

// 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

構文

説明

備考

例

関連項目