PDFium Delphi Component Docs

LoadingText Свойство

Компонент: TPdfView  ·  Модуль: PDFium
Текст, который показывается в центре страницы, пока асинхронная отрисовка ещё идёт

Syntax

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

Description

LoadingText — подпись, которую вьювер накладывает поверх частично отрендеренной страницы, когда AsyncRendering равно True. Вьювер измеряет строку текущим унаследованным шрифтом, разворачивает результат в центрированный прямоугольник, заливает его LoadingColor и рисует текст поверх. Умолчание 'Loading...' пользователи узнают как переходное состояние, и оно достаточно широкое, чтобы быть видимым, не забивая страницу

Оверлей ключуется на текст, а не на отдельный флаг видимости. Пустая строка ('') подавляет оверлей, даже пока асинхронный рендеринг активен — полезно, когда приложение-хост хочет показать собственный виджет загрузки (анимированный GIF, модальный диалог прогресса, отдельную панель статус-бара) и не хочет, чтобы встроенный прямоугольник конкурировал за внимание

Локализуйте строку, назначив переведённый ресурс при старте; свойство принимает любую string, которую способно выдать приложение-хост, включая многобайтные символы — китайские, японские, арабские

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