Документация PDFiumPas

LoadingText Свойство

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

Синтаксис

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

Описание

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

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

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

Примечания

Пример

// локализованная подпись загрузки
PdfView1.AsyncRendering := True;
PdfView1.LoadingText := SLoadingPdf; // resourcestring lookup

// подавить встроенный индикатор; вместо него использовать TActivityIndicator
PdfView1.LoadingText := '';
ActivityIndicator1.Animate := True;

// сообщение для медленной первой отрисовки на конкретном этапе
PdfView1.LoadingText := 'Decoding first page...';
PdfView1.Active := True;

См. также

LoadingColor, AsyncRendering, Font, Active