PDFium Delphi Component Docs

LoadingText Proprietà

Componente: TPdfView  ·  Unità: PDFium
Testo mostrato al centro della pagina mentre il rendering asincrono è ancora in corso

Syntax

property LoadingText: string; // default 'Loading...'

Description

LoadingText è la didascalia che il viewer sovrappone a una pagina parzialmente renderizzata quando AsyncRendering è True. Il viewer misura la stringa con il font ereditato corrente, espande il risultato in un rettangolo centrato, lo riempie con LoadingColor e poi disegna il testo sopra. Il predefinito 'Caricamento...' è riconoscibile dagli utenti come stato transitorio ed è abbastanza largo da vedersi senza dominare la pagina

L'overlay è comandato dal testo, non da un flag di visibilità separato. Assegnare una stringa vuota ('') sopprime l'overlay anche mentre il rendering asincrono è attivo — utile quando l'applicazione host vuole mostrare il proprio widget di caricamento (una GIF animata, un dialogo di avanzamento modale, un pannello della status bar) e preferisce che il rettangolo incorporato non faccia concorrenza

Localizza la stringa assegnando una risorsa tradotta all'avvio; la proprietà accetta qualsiasi string prodotta dall'applicazione host, compresi i caratteri multibyte come cinese, giapponese o arabo

Remarks

Example

// Localized loading caption.
PdfView1.AsyncRendering := True;
PdfView1.LoadingText := SLoadingPdf; // resourcestring lookup

// Suppress the built-in indicator; use a TActivityIndicator instead.
PdfView1.LoadingText := '';
ActivityIndicator1.Animate := True;

// Stage-specific message for slow first paint.
PdfView1.LoadingText := 'Decoding first page...';
PdfView1.Active := True;

See Also

LoadingColor, AsyncRendering, Font, Active