PDFium Component Docs

LoadingColor 속성

이 API 항목은 식별자, 시그니처, 코드 블록, PDF 용어를 원래 형태로 유지합니다.
컴포넌트: TPdfView  ·  유닛: PDFium
페이지가 아직 렌더링되는 동안 그려지는 “loading” placeholder의 채우기 색입니다

구문

property LoadingColor: TColor; // default clYellow

설명

AsyncRenderingTrue이면 뷰어는 실제 page bitmap이 아직 생성되는 동안 보이는 페이지 중앙에 placeholder rectangle을 그립니다. LoadingColor는 그 rectangle의 background를 제어합니다. 기본값 clYellow은 일반적인 흰색 page bitmap과 높은 대비를 이루므로, 뒤에서 페이지가 이미 그려지기 시작했더라도 표시기가 또렷하게 보입니다

placeholder는 LoadingText가 비어 있지 않을 때만 그려집니다. rectangle의 크기는 텍스트가 정하기 때문입니다. LoadingText를 빈 문자열로 설정하면 LoadingColor와 무관하게 overlay가 완전히 꺼집니다

LoadingColor를 run-time에 바꾸면 다음 paint cycle에 반영됩니다. 이 색은 실제로 렌더링된 PDF content에는 영향을 주지 않고, loading indicator에만 영향을 줍니다

비고

예제

// 페이지 중앙에 Adobe 스타일 loading badge를 표시합니다
PdfView1.AsyncRendering := True;
PdfView1.LoadingColor := $00E0E0E0; // light gray
PdfView1.LoadingText := 'Rendering page...';

// accessibility-mode UI에 맞게 high-contrast badge로 전환합니다
if AccessibilityHighContrast then
begin
  PdfView1.LoadingColor := clBlack;
  PdfView1.Font.Color := clYellow;
end;

참고 항목

LoadingText, AsyncRendering, PageColor, Color