PageColor Propriedade

Antes da v1.18.0, a página PDF renderizada usava a propriedade Color do TPdfView como plano de fundo. Isso era incômodo para aplicações em modo escuro: definir Color := clBlack para integrar o visualizador a uma UI escura também pintava as páginas PDF sobre um fundo preto, o que fazia qualquer documento com regiões transparentes parecer errado

PageColor desacopla as duas superfícies:

• Color — o plano de fundo da área de rolagem, pintado no vão entre o retângulo da página e a borda do controle. Tematizado pela aplicação hospedeira
• PageColor — o plano de fundo da página PDF, pintado dentro do retângulo da página, atrás de qualquer conteúdo renderizado. O padrão é clWhite

O padrão clWhite significa que as páginas PDF são renderizadas como papel branco independentemente do tema da aplicação hospedeira — correspondendo ao aspecto que todos os outros leitores de PDF oferecem. Aplicações que anteriormente definiam TPdfView.Color para recolorir a página PDF devem definir PageColor em vez disso; o novo padrão é uma melhoria estrita para o caso comum

• A camada de renderização de página pinta sobre PageColor — uma página com conteúdo opaco mostra esse conteúdo; uma página com regiões transparentes mostra PageColor através delas
• Combine PageColor com PageShadowSize / PageShadowColor / PageBorderColor para o visual clássico de "página branca sobre tela escura com sombra projetada"
• PageColor é um TColor — o alfa é implícito ($FF). Para sobreposições semitransparentes, use um manipulador de pintura personalizado