PDFium Delphi Component Docs

LoadingText Egenskap

Component: TPdfView  ·  Unit: PDFium
Text som visas i mitten av sidan medan asynkron rendering fortfarande pågår

Syntax

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

Description

LoadingText är texten som visaren lägger över en delvis renderad sida när AsyncRendering är True. Visaren mäter strängen med sitt aktuella ärvda typsnitt, expanderar resultatet till en centrerad rektangel, fyller den med LoadingColor och ritar sedan texten ovanpå. Standardvärdet 'Loading...' känns igen av användare som ett övergångstillstånd och är brett nog för att synas utan att dominera sidan

Överlägget styrs av texten i stället för av en separat synlighetsflagga. Tilldelning av en tom sträng ('') undertrycker överlägget även medan asynkron rendering är aktiv — användbart när värdprogrammet vill visa sin egen laddningswidget (en animerad GIF, en modal förloppsdialog, en separat statusradspanel) och hellre slipper att den inbyggda rektangeln konkurrerar om uppmärksamheten

Lokalisera strängen genom att tilldela en översatt resurs vid uppstart; egenskapen accepterar vilken string som helst som värdprogrammet kan producera, inklusive flerteckensbytecken som kinesiska, japanska eller arabiska

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