PageColor - TPdfView - PDFium Delphi Component

컴포넌트: TPdfView · 유닛: PDFium

렌더링된 PDF page 아래에 칠해지는 background colour로, 주변 control의 Color와는 분리됩니다. 기본값은 clWhite이므로 host control의 Color가 어두운 theme여도 PDF page는 종이처럼 흰색으로 유지됩니다

Syntax

property PageColor: TColor;

Description

v1.18.0 이전에는 렌더링된 PDF 페이지가 TPdfView의 Color 프로퍼티를 배경으로 썼습니다. 다크 모드 애플리케이션에서는 이게 골칫거리였습니다. 뷰어를 어두운 UI에 녹이려고 Color := clBlack으로 두면 PDF 페이지까지 검은 배경 위에 그려져서, 투명한 영역이 있는 문서는 어색해 보였습니다

PageColor는 이 두 표면을 분리합니다

Color — 스크롤 영역 배경으로, 페이지 사각형과 컨트롤 가장자리 사이의 틈에 그려집니다. 호스트 애플리케이션이 테마를 정합니다
PageColor — PDF 페이지 배경으로, 페이지 사각형 안쪽의 렌더링된 콘텐츠 뒤에 그려집니다. 기본값은 clWhite

기본값이 clWhite이므로 PDF 페이지는 호스트 애플리케이션 테마와 무관하게 종이 흰색으로 렌더링됩니다 — 다른 모든 PDF 리더가 주는 모양과 같습니다. 이전에 TPdfView.Color로 PDF 페이지 색을 바꾸던 애플리케이션은 이제 PageColor를 설정해야 합니다. 새 기본값은 흔한 사례에서 확실한 개선입니다

Remarks

페이지 렌더 레이어는 PageColor 위에 그립니다 — 불투명한 콘텐츠가 있는 페이지는 그 콘텐츠를 보여 주고, 투명한 영역이 있는 페이지는 그 영역을 통해 PageColor가 비칩니다
PageColor를 PageShadowSize / PageShadowColor / PageBorderColor와 조합하면 전통적인 "어두운 캔버스 위 드롭 섀도우가 있는 흰 페이지" 모양이 됩니다
PageColor는 TColor이며 알파는 암시적으로($FF)입니다. 반투명 오버레이가 필요하면 커스텀 그리기 핸들러를 쓰세요

Example

// 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;

PageColor 속성

컴포넌트: TPdfView · 유닛: PDFium

Syntax

Description

Remarks

Example

See Also