PDFium Component Docs

LoadingColor eigenschap

Component: TPdfView  ·  Unit: PDFium
Opvulkleur van de tijdelijke aanduiding “bezig met laden” die wordt getekend terwijl een pagina nog wordt gerenderd

Syntax

property LoadingColor: TColor; // default clYellow

Description

Wanneer AsyncRendering True is, tekent de viewer een rechthoek als tijdelijke aanduiding in het midden van de zichtbare pagina terwijl de werkelijke pagina-bitmap nog wordt gegenereerd. LoadingColor bepaalt de achtergrond van die rechthoek. De standaardwaarde clYellow biedt hoog contrast met de typische witte pagina-bitmap, zodat de indicator duidelijk zichtbaar is, zelfs wanneer de pagina erachter al begint te tekenen.

De tijdelijke aanduiding wordt alleen getekend wanneer LoadingText niet leeg is — de tekst bepaalt de grootte van de rechthoek. LoadingText instellen op een lege string schakelt de overlay volledig uit, ongeacht LoadingColor.

Het wijzigen van LoadingColor tijdens runtime wordt bij de volgende tekenbeurt van kracht. De kleur beïnvloedt de werkelijk gerenderde PDF-inhoud niet, alleen de laadindicator.

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