PDFium Component Docs

LoadingColor Eigenschaft

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.
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

Beschreibung

Wenn AsyncRendering True ist, zeichnet der Viewer ein Platzhalterrechteck in der Mitte der sichtbaren Seite, während das eigentliche Seiten-Bitmap noch erzeugt wird. LoadingColor steuert den Hintergrund dieses Rechtecks. Der Standardwert clYellow bietet hohen Kontrast zum typischen weißen Seiten-Bitmap, sodass der Hinweis auch dann klar sichtbar bleibt, wenn die Seite bereits dahinter zu zeichnen begonnen hat

Der Platzhalter wird nur gezeichnet, wenn LoadingText nicht leer ist — der Text bestimmt die Größe des Rechtecks. Das Setzen von LoadingText auf eine leere Zeichenkette deaktiviert das Overlay vollständig, unabhängig von LoadingColor

Das Ändern von LoadingColor zur Laufzeit wirkt sich im nächsten Paint-Zyklus aus. Die Farbe beeinflusst nicht den eigentlichen gerenderten PDF-Inhalt, sondern nur den Ladehinweis

Hinweise

Beispiel

// Ein Adobe-ähnliches Lade-Badge in der Seitenmitte aktivieren
PdfView1.AsyncRendering := True;
PdfView1.LoadingColor := $00E0E0E0; // hellgrau
PdfView1.LoadingText := 'Rendering page...';

// Für die Bedienungshilfe auf ein kontrastreiches Badge umschalten
if AccessibilityHighContrast then
begin
  PdfView1.LoadingColor := clBlack;
  PdfView1.Font.Color := clYellow;
end;

Siehe auch

LoadingText, AsyncRendering, PageColor, Color