PDFium Delphi Component Docs

LoadingText Propriedade

Componente: TPdfView  ·  Unidade: PDFium
Texto mostrado no centro da página enquanto a renderização assíncrona ainda está em andamento

Syntax

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

Description

LoadingText é a legenda que o visualizador sobrepõe sobre uma página parcialmente renderizada quando AsyncRendering é True. O visualizador mede a string com sua fonte herdada atual, expande o resultado em um retângulo centralizado, preenche-o com LoadingColor e então desenha o texto por cima. O padrão 'Loading...' é reconhecido pelos usuários como um estado transitório e é largo o suficiente para ficar visível sem dominar a página

A sobreposição é controlada pelo texto, e não por um sinalizador de visibilidade separado. Atribuir uma string vazia ('') suprime a sobreposição mesmo enquanto a renderização assíncrona está ativa — útil quando o aplicativo hospedeiro quer exibir seu próprio widget de carregamento (um GIF animado, um diálogo modal de progresso, um painel separado na barra de status) e prefere que o retângulo integrado não dispute atenção

Localize a string atribuindo um recurso traduzido na inicialização; a propriedade aceita qualquer string que o aplicativo hospedeiro possa produzir, incluindo caracteres multibyte como chinês, japonês ou á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