PageColor Eigenschaft

Hintergrundfarbe, die unter die gerenderte PDF-Seite gemalt wird, entkoppelt von der Color-Eigenschaft des umgebenden Steuerelements. Der Standardwert ist clWhite, damit PDF-Seiten papierweiß bleiben, auch wenn die Color-Eigenschaft des Host-Steuerelements dunkel thematisiert ist

Vor v1.18.0 verwendete die gerenderte PDF-Seite die Color-Eigenschaft der TPdfView als Hintergrund. Das war für Dark-Mode-Anwendungen unpraktisch: Wer mit Color := clBlack den Viewer in eine dunkle UI einbettete, malte auch die PDF-Seiten auf einen schwarzen Untergrund, wodurch jedes Dokument mit transparenten Bereichen falsch aussah

PageColor entkoppelt die beiden Flächen:

• Color — der Hintergrund des Bildlaufbereichs, gemalt in der Lücke zwischen Seitenrechteck und Steuerelementrand. Wird von der Host-Anwendung thematisiert
• PageColor — der Hintergrund der PDF-Seite, gemalt innerhalb des Seitenrechtecks hinter allen gerenderten Inhalten. Voreingestellt auf clWhite

Der Standardwert clWhite bedeutet, dass PDF-Seiten unabhängig vom Design der Host-Anwendung papierweiß gerendert werden — passend zum Erscheinungsbild jedes anderen PDF-Programms. Anwendungen, die zuvor TPdfView.Color gesetzt haben, um die PDF-Seite umzufärben, sollten stattdessen PageColor setzen; der neue Standardwert ist für den Normalfall eine klare Verbesserung

• Die Seitenrender-Ebene malt über PageColor — eine Seite mit opakem Inhalt zeigt diesen Inhalt; eine Seite mit transparenten Bereichen lässt PageColor durchscheinen
• Kombinieren Sie PageColor mit PageShadowSize / PageShadowColor / PageBorderColor für den klassischen Look einer weißen Seite auf dunkler Fläche mit Schattenwurf
• PageColor ist ein TColor — der Alphakanal ist implizit ($FF). Für halbtransparente Overlays verwenden Sie stattdessen einen eigenen Paint-Handler

Color, PageShadowColor, PageShadowSize, PageBorderColor