PDFium Delphi Component Docs

LoadingColor Eigenschaft

Komponente: TPdfView  ·  Unit: PDFium
Füllfarbe des Platzhalters „loading“, der gezeichnet wird, während eine Seite noch gerendert wird

Syntax

property LoadingColor: TColor; // default clYellow

Description

Ist AsyncRendering True, zeichnet der Viewer ein Platzhalter-Rechteck in die Mitte der sichtbaren Seite, solange die eigentliche Seiten-Bitmap noch erzeugt wird. LoadingColor steuert den Hintergrund dieses Rechtecks. Das Standard-clYellow kontrastiert stark mit der typischerweise weißen Seiten-Bitmap, sodass der Indikator klar sichtbar bleibt, selbst wenn die Seite hinter ihm schon anfängt zu malen

Der Platzhalter wird nur gemalt, wenn LoadingText nicht leer ist — der Text gibt dem Rechteck seine Größe. LoadingText auf eine leere Zeichenkette setzen schaltet das Overlay komplett ab, unabhängig von LoadingColor

Eine Änderung von LoadingColor zur Laufzeit greift im nächsten Paint-Zyklus. Die Farbe berührt nicht den tatsächlich gerenderten PDF-Inhalt, nur den Ladeindikator

Remarks

Example

// Enable an Adobe-style loading badge in the center of the page.
PdfView1.AsyncRendering := True;
PdfView1.LoadingColor := $00E0E0E0; // light gray
PdfView1.LoadingText := 'Rendering page...';

// Switch to a high-contrast badge for accessibility-mode UI.
if AccessibilityHighContrast then
begin
  PdfView1.LoadingColor := clBlack;
  PdfView1.Font.Color := clYellow;
end;

See Also

LoadingText, AsyncRendering, PageColor, Color