PDFium Delphi Component Docs

PageColor Egenskap

Component: TPdfView  ·  Unit: PDFium
Bakgrundsfärg som målas under den renderade PDF-sidan, frikopplad från den omgivande kontrollens Color. Standardvärdet är clWhite så att PDF-sidor förblir pappersvita även när värdkontrollens Color är mörktemad

Syntax

property PageColor: TColor;

Description

Före v1.18.0 använde den renderade PDF-sidan TPdfView-kontrollens Color-egenskap som bakgrund. Det var besvärligt för program med mörkt läge: att ställa in Color := clBlack för att låta visaren smälta in i ett mörkt användargränssnitt målade även PDF-sidor mot en svart bakgrund, vilket fick dokument med transparanta områden att se felaktiga ut

PageColor frikopplar de två ytorna:

Standardvärdet clWhite innebär att PDF-sidor renderas som pappersvita oavsett värdprogrammets tema — vilket motsvarar utseendet i alla andra PDF-läsare. Program som tidigare ställde in TPdfView.Color för att ändra PDF-sidans färg bör i stället ställa in PageColor; det nya standardvärdet är en ren förbättring i det vanliga fallet

Remarks

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;

See Also

Color, PageShadowColor, PageShadowSize, PageBorderColor