PageColor Propriété

Couleur d’arrière-plan peinte sous la page PDF rendue, découplée du Color. Par défaut clWhite, afin que les pages PDF restent blanches comme du papier même quand le Color du contrôle hôte suit un thème sombre

Avant v1.18.0, la page PDF rendue utilisait la Color comme arrière-plan. C'était gênant pour les applications en mode sombre : définir Color := clBlack pour fondre la visionneuse dans une interface sombre peignait aussi les pages PDF sur un fond noir, ce qui faisait mal rendre tout document comportant des régions transparentes

PageColor découple les deux surfaces

• Color — l'arrière-plan de la zone de défilement, peint dans l'espace entre le rectangle de page et le bord du contrôle. Thématisé par l'application hôte
• PageColor — l'arrière-plan de la page PDF, peint à l'intérieur du rectangle de page, derrière tout contenu rendu. La valeur par défaut est clWhite

La valeur par défaut clWhite signifie que les pages PDF s'affichent en blanc papier quelle que soit l'apparence de l'application hôte — conformément à l'aspect donné par toutes les autres visionneuses PDF. Les applications qui utilisaient auparavant TPdfView.Color pour recolorer la page PDF doivent désormais définir PageColor à la place ; la nouvelle valeur par défaut constitue une amélioration nette pour le cas courant

• La couche de rendu de page peint par-dessus PageColor — une page au contenu opaque montre ce contenu ; une page aux régions transparentes montre PageColor à travers elles
• Combinez PageColor avec PageShadowSize / PageShadowColor / PageBorderColor pour le look classique « page blanche sur fond sombre avec ombre portée »
• PageColor est un TColor — l’alpha est implicite ($FF). Pour des superpositions semi-transparentes, utilisez plutôt un gestionnaire de peinture personnalisé

Color, PageShadowColor, PageShadowSize, PageBorderColor