Color와는 분리됩니다. 기본값은 clWhite이므로 host control의 Color가 어두운 theme여도 PDF page는 종이처럼 흰색으로 유지됩니다property PageColor: TColor;
v1.18.0 이전에는 렌더링된 PDF page가 TPdfView의 Color property를 background로 사용했습니다. 이는 dark-mode application에서는 불편했습니다. viewer를 dark UI에 자연스럽게 섞이게 하려고 Color := clBlack을 설정하면 PDF page도 black backdrop 위에 그려져서 transparent region이 있는 document가 잘못 보였기 때문입니다
PageColor는 두 surface를 분리합니다
clWhite입니다기본값 clWhite는 host application의 theme와 무관하게 PDF page가 paper-white로 렌더링된다는 뜻입니다 — 다른 모든 PDF reader가 보이는 모습과 같습니다. 이전에 PDF page 색을 바꾸기 위해 TPdfView.Color를 설정하던 application은 대신 PageColor를 설정해야 합니다. 새 기본값은 일반적인 경우에 더 낫습니다
PageColor 위에 그립니다. 불투명한 content가 있는 page는 그 content를 보여 주고, transparent region이 있는 page는 그 사이로 PageColor를 드러냅니다PageColor를 PageShadowSize / PageShadowColor / PageBorderColor와 함께 사용하면 전형적인 "dark canvas 위의 white page와 drop shadow" 느낌을 만들 수 있습니다PageColor는 TColor입니다. alpha는 암시적($FF)입니다. 반투명 overlay가 필요하면 대신 custom paint handler를 사용하세요
// Dark-mode viewer pattern: dark scroll area, paper-white PDF page
PdfView1.Color := clBlack;
PdfView1.PageColor := clWhite;
// Sepia-tinted reader background
PdfView1.PageColor := $00C8E3F4; // BGR — soft amber
// Restore pre-v1.18.0 behavior where Color sets the page background
PdfView1.PageColor := PdfView1.Color;