PageColor Eigenschaft

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.

Hintergrundfarbe, die unter die gerenderte PDF-Seite gezeichnet wird, getrennt von Color des umgebenden Steuerelements. Standard ist clWhite, damit PDF-Seiten papierweiß bleiben, selbst wenn Color des Host-Steuerelements dunkel gestaltet ist

Vor v1.18.0 verwendete die gerenderte PDF-Seite die Eigenschaft Color von TPdfView als Hintergrund. Das war für Dark-Mode-Anwendungen unpraktisch: Das Setzen von Color := clBlack, um den Viewer in eine dunkle UI einzupassen, zeichnete PDF-Seiten ebenfalls auf einen schwarzen Hintergrund und ließ Dokumente mit transparenten Bereichen falsch aussehen

PageColor trennt die beiden Flächen

• Color — der Hintergrund des Scrollbereichs, gezeichnet in der Lücke zwischen dem Seitenrechteck und dem Steuerrand. Vom Host angelegt gestaltet
• PageColor — der Hintergrund der PDF-Seite, gezeichnet innerhalb des Seitenrechtecks hinter dem gerenderten Inhalt. Standard ist clWhite

Der Standard clWhite sorgt dafür, dass PDF-Seiten papierweiß gerendert werden, unabhängig vom Thema der Hostanwendung — so wie es jeder andere PDF-Reader zeigt. Anwendungen, die bisher TPdfView.Color gesetzt haben, um die PDF-Seite neu zu färben, sollten stattdessen PageColor setzen; der neue Standard ist für den üblichen Fall eine klare Verbesserung

• Die Seiten-Render-Ebene malt über PageColor hinweg — eine Seite mit opakem Inhalt zeigt diesen Inhalt, eine Seite mit transparenten Bereichen zeigt PageColor durch
• Kombinieren Sie PageColor mit PageShadowSize / PageShadowColor / PageBorderColor für den klassischen Look "weiße Seite auf dunkler Fläche mit Schatten"
• PageColor ist ein TColor — Alpha ist implizit ($FF). Für halbtransparente Overlays verwenden Sie stattdessen einen eigenen Paint-Handler

Color, PageShadowColor, PageShadowSize, PageBorderColor