PDFium Delphi Component 文件

LoadingText 属性

组件: TPdfView  ·  单元: PDFium
在异步渲染仍在进行时显示在页面中央的文本

Syntax

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

Description

LoadingText 是当 AsyncRendering 为 True 时查看器叠加在部分渲染页面上的标题。查看器用其当前继承字体测量字符串,将结果展开为居中矩形,用 LoadingColor 填充,然后在上面绘制文本。默认 'Loading...' 对用户而言是可识别的瞬态,宽度足够可见而不占满页面

覆盖层以文本为键,而非单独的可见性标志。赋值空字符串('')会在异步渲染活动时抑制覆盖层 — 当宿主应用程序想显示自己的加载控件(动画 GIF、模态进度对话框、单独的状态栏面板)且不希望内置矩形争夺注意力时很有用

在启动时赋值翻译后的资源来本地化字符串;该属性接受宿主应用程序可以生成的任何 string,包括中文、日文或阿拉伯文等多字节字符

Remarks

Example

// 本地化的加载标题
PdfView1.AsyncRendering := True;
PdfView1.LoadingText := SLoadingPdf; // resourcestring 查找

// 抑制内置指示器;改用 TActivityIndicator
PdfView1.LoadingText := '';
ActivityIndicator1.Animate := True;

// 针对缓慢首次绘制的分阶段消息
PdfView1.LoadingText := 'Decoding first page...';
PdfView1.Active := True;

See Also

LoadingColor, AsyncRendering, Font, Active