PageColor Eigenschap

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.

Achtergrondkleur die onder de gerenderde PDF-pagina wordt geverfd, los van de Color van de omliggende besturing. Standaard is dit clWhite zodat PDF-pagina's papierwit blijven, zelfs wanneer de Color van de hostbesturing donker is gethematiseerd

Voor v1.18.0 gebruikte de gerenderde PDF-pagina de Color-eigenschap van TPdfView als achtergrond. Dat was onhandig voor toepassingen in donkere modus: door Color := clBlack in te stellen om de viewer in een donkere UI te laten opgaan, werden PDF-pagina's ook op een zwarte achtergrond geverfd, waardoor elk document met transparante gebieden er verkeerd uitzag

PageColor scheidt die twee oppervlakken

• Color — de achtergrond van het scrollgebied, geverfd in de ruimte tussen de paginarechthoek en de rand van de besturing. Gevormd door het hosttoepassingsthema
• PageColor — de achtergrond van de PDF-pagina, geverfd binnen de paginarechthoek, achter alle gerenderde inhoud. Standaard is clWhite

De standaard clWhite betekent dat PDF-pagina's papierwit worden gerenderd ongeacht het thema van de hosttoepassing — wat overeenkomt met de uitstraling die elke andere PDF-reader geeft. Toepassingen die eerder TPdfView.Color instelden om de PDF-pagina van kleur te veranderen moeten in plaats daarvan PageColor instellen; de nieuwe standaard is een duidelijke verbetering voor het gebruikelijke geval

• De pagina-renderlaag tekent boven op PageColor — een pagina met ondoorzichtige inhoud toont die inhoud; een pagina met transparante delen toont PageColor erdoorheen
• Combineer PageColor met PageShadowSize / PageShadowColor / PageBorderColor voor de klassieke "witte pagina op donker canvas met slagschaduw"-look
• PageColor is een TColor — alpha is impliciet ($FF). Gebruik voor halftransparante overlays in plaats daarvan een aangepaste paint-handler

Color, PageShadowColor, PageShadowSize, PageBorderColor