PDFium Delphi Component 文件

Active 属性

组件: TPdfView  ·  单元: PDFium
激活或停用查看器,打开绑定的 PDF 文档并渲染所选页面

Syntax

property Active: Boolean; // default False

Description

将 Active 设为 True 会指示查看器加载关联 Pdf 组件引用的文档,打开由 PageNumber 标识的页面,并触发重绘。将其设为 False 会关闭页面、释放缓存的文本页句柄、丢弃查找会话并清除可见区域

Active 是查看器的主开关。与文档相关的属性,如 PageCount、PageWidth、PageLabel 以及索引访问器(Character、Bitmap、WebLink 等),仅在 Active 为 True 且链接的 Pdf 实例已加载文档时才返回有意义的值

如果 Pdf 为 nil,查看器会在 Active 首次设为 True 时创建并拥有一个内部 TPdf 实例,因此最小程序可以在指向文件后简单地调用 PdfView1.Pdf.FileName := ...; PdfView1.Active := True;

Remarks

Example

// 绑定到显式 TPdf 并打开文件
PdfView1.Pdf := Pdf1;
Pdf1.FileName := 'C:\docs\sample.pdf';
PdfView1.Active := True;

// 在代码中响应打开/关闭
if PdfView1.Active then
  StatusBar1.SimpleText := Format('%d pages', [PdfView1.PageCount])
else
  StatusBar1.SimpleText := 'No document loaded';

// 关闭查看器
PdfView1.Active := False;

See Also

Pdf, PageNumber, PageCount, ReloadPage, TPdf.Active