PDFium Component Docs

LoadingText Eigenschap

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.
Component: TPdfView  ·  Unit: PDFium
Tekst die in het midden van de pagina wordt getoond terwijl asynchrone rendering nog bezig is

Syntaxis

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

Beschrijving

LoadingText is de titel die de viewer boven op een gedeeltelijk gerenderde pagina plaatst wanneer AsyncRendering True is. De viewer meet de string met het huidige geërfde lettertype, zet het resultaat uit tot een gecentreerde rechthoek, vult die met LoadingColor en tekent dan de tekst erbovenop. De standaard 'Loading...' is voor gebruikers herkenbaar als een tijdelijke toestand en is breed genoeg om zichtbaar te zijn zonder de pagina te domineren

De overlay wordt bepaald door de tekst en niet door een aparte zichtbaarheidsvlag. Door een lege string ('') toe te wijzen onderdruk je de overlay zelfs terwijl asynchrone rendering actief is — handig wanneer de hosttoepassing zijn eigen laadwidget wil tonen (een geanimeerde GIF, een modale voortgangsdialoog, een apart statusbalkpaneel) en het ingebouwde vak niet om aandacht wil laten concurreren

Localiseer de string door bij het starten 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

Opmerkingen

Voorbeeld

// 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;

Zie ook

LoadingColor, AsyncRendering, Font, Active