PDFium Delphi Component Docs

LoadingColor Proprietà

Componente: TPdfView  ·  Unità: PDFium
Colore di riempimento del segnaposto “loading” disegnato mentre una pagina è ancora in fase di rendering

Syntax

property LoadingColor: TColor; // default clYellow

Description

Quando AsyncRendering è True il viewer disegna un rettangolo segnaposto al centro della pagina visibile mentre la bitmap della pagina vera è ancora in generazione. LoadingColor controlla lo sfondo di quel rettangolo. Il predefinito clYellow dà un contrasto elevato rispetto alla tipica bitmap di pagina bianca così l'indicatore resta ben visibile anche quando la pagina ha già iniziato a dipingersi sotto

Il segnaposto viene disegnato solo quando LoadingText non è vuoto — è il testo a dare le dimensioni al rettangolo. Impostare LoadingText a una stringa vuota disabilita del tutto l'overlay indipendentemente da LoadingColor

Cambiare LoadingColor a runtime vale dal ciclo di disegno successivo. Il colore non tocca il contenuto PDF realmente renderizzato, ma solo l'indicatore di caricamento

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