PDFium Delphi Component Docs

LoadingText Propriété

Composant: TPdfView  ·  Unit: PDFium
Texte affiché au centre de la page pendant que le rendu asynchrone est encore en cours

Syntax

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

Description

LoadingText est la légende que la visionneuse superpose sur une page partiellement rendue lorsque AsyncRendering vaut True. La visionneuse mesure la chaîne avec sa police héritée courante, transforme le résultat en rectangle centré, le remplit avec LoadingColor, puis dessine le texte par-dessus. La valeur par défaut 'Loading...' est reconnaissable par les utilisateurs comme un état transitoire et suffisamment large pour rester visible sans dominer la page

La superposition dépend du texte plutôt que d'un drapeau de visibilité séparé. Affecter une chaîne vide ('') supprime la superposition même lorsque le rendu asynchrone est actif — utile lorsque l'application hôte veut afficher son propre widget de chargement (GIF animé, boîte de progression modale, panneau séparé de barre d'état) et préfère ne pas laisser le rectangle intégré attirer l'attention

Localisez la chaîne en affectant une ressource traduite au démarrage ; la propriété accepte n'importe quelle string que l'application hôte peut produire, y compris des caractères multi-octets comme le chinois, le japonais ou l'arabe

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