PDFium Delphi Component Docs

PageColor Proprietà

Componente: TPdfView  ·  Unità: PDFium
Colore di sfondo dipinto sotto la pagina PDF renderizzata, separato dalla proprietà Color del controllo circostante. Il valore predefinito è clWhite così le pagine PDF restano bianche come carta anche quando la Color del controllo ospite è impostata su un tema scuro

Syntax

property PageColor: TColor;

Description

Prima di v1.18.0 la pagina PDF renderizzata usava la proprietà Color di TPdfView come sfondo. Era scomodo per le applicazioni in modalità scura: impostare Color := clBlack per fondere il visualizzatore in un'interfaccia scura dipingeva anche le pagine PDF su uno sfondo nero, il che dava un aspetto errato a qualsiasi documento con aree trasparenti

PageColor separa le due superfici:

Il valore predefinito clWhite fa sì che le pagine PDF vengano renderizzate bianche come carta a prescindere dal tema dell'applicazione ospite — con l'aspetto che ogni altro lettore PDF offre. Le applicazioni che in precedenza impostavano TPdfView.Color per ricolorare la pagina PDF devono impostare PageColor; il nuovo predefinito è un miglioramento netto per il caso comune

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