PDFium Component Docs

LoadingColor Eigenschap

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.
Component: TPdfView  ·  Unit: PDFium
Vulkleur van de “loading”-placeholder die wordt getekend terwijl een pagina nog wordt gerenderd

Syntaxis

property LoadingColor: TColor; // default clYellow

Beschrijving

Wanneer AsyncRendering True is, tekent de viewer een plaatsaanduidende rechthoek in het midden van de zichtbare pagina terwijl de werkelijke paginabitmap nog wordt gegenereerd. LoadingColor bepaalt de achtergrond van die rechthoek. De standaard clYellow biedt hoog contrast tegen de gebruikelijke witte paginabitmap, zodat de indicator duidelijk zichtbaar is zelfs wanneer de pagina al achter de indicator begint te tekenen

De plaatsaanduiding wordt alleen getekend wanneer LoadingText niet leeg is — de tekst bepaalt de grootte van de rechthoek. Door LoadingText op een lege string te zetten, schakel je de overlay volledig uit ongeacht LoadingColor

Wijzigingen aan LoadingColor tijdens runtime worden actief in de volgende paintcyclus. De kleur heeft geen effect op de daadwerkelijk gerenderde PDF-inhoud, alleen op de laadindicator

Opmerkingen

Voorbeeld

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

Zie ook

LoadingText, AsyncRendering, PageColor, Color