PDFium Delphi Component Docs

LoadingText Propiedad

Componente: TPdfView  ·  Unidad: PDFium
Texto que se muestra en el centro de la página mientras el render asíncrono sigue en progreso

Syntax

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

Description

LoadingText es el rótulo que el visor superpone sobre una página parcialmente renderizada cuando AsyncRendering es True. El visor mide la cadena con su fuente heredada actual, expande el resultado en un rectángulo centrado, lo rellena con LoadingColor y luego dibuja el texto encima. El valor 'Loading...' predeterminado es reconocible para los usuarios como un estado transitorio y es lo bastante ancho para ser visible sin dominar la página

La superposición depende del texto y no de un indicador de visibilidad aparte. Asignar una cadena vacía ('') suprime la superposición incluso mientras el render asíncrono está activo — útil cuando la aplicación anfitriona quiere mostrar su propio widget de carga (un GIF animado, un diálogo modal de progreso, un panel aparte de la barra de estado) y prefiere que el rectángulo integrado no compita por la atención

Localice la cadena asignando un recurso traducido al inicio; la propiedad acepta cualquier string que la aplicación anfitriona pueda producir, incluidos caracteres multibyte como chino, japonés o árabe

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