PDFium Component Docs

LoadingText eigenschap

Component: TPdfView  ·  Unit: PDFium
Tekst die in het midden van de pagina wordt getoond terwijl asynchroon renderen nog loopt

Syntax

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

Description

LoadingText is het bijschrift dat de viewer over een gedeeltelijk gerenderde pagina legt wanneer AsyncRendering True is. De viewer meet de string met zijn huidige overgeërfde lettertype, breidt het resultaat uit tot een gecentreerde rechthoek, vult deze met LoadingColor en tekent vervolgens de tekst erbovenop. De standaardwaarde 'Loading...' is voor gebruikers herkenbaar als een tijdelijke toestand en is breed genoeg om zichtbaar te zijn zonder de pagina te domineren.

De overlay is gebaseerd op de tekst in plaats van op een aparte zichtbaarheidvlag. Het toewijzen van een lege string ('') onderdrukt de overlay, zelfs terwijl asynchroon renderen actief is — nuttig wanneer de hosttoepassing zijn eigen laadwidget wil tonen (een geanimeerde GIF, een modale voortgangsdialoog, een apart statusbalkpaneel) en liever niet de ingebouwde rechthoek om aandacht laat concurreren.

Lokaliseer de string door bij het opstarten een vertaalde resource toe te wijzen; de eigenschap accepteert elke string die de hosttoepassing kan produceren, inclusief multi-byte tekens zoals Chinees, Japans of Arabisch.

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