PDFiumPas 文档

Active 属性

此 API 条目保留标识符、签名、代码块和 PDF 术语的原始形式
组件: TPdf  ·  单元: PDFium
打开或关闭选定的 PDF 文档

语法

property Active: Boolean; // default False

说明

Active 设为 True 会打开并加载由 FileName 指定的 PDF 文档,若文档已加密则使用 Password。设为 False 时,文档会关闭,所有关联的 PDFium 资源(页面、字体、表单句柄、文本页)都会释放

你也可以直接调用 LoadDocument,而不是切换这个属性。当 Active 已经为 True 时再次赋值 FileName 会自动从新路径重新加载文档,这也是在单个 TPdf 实例中切换多个 PDF 的推荐方式

如果文件无法打开(路径错误、密码错误、PDF 损坏或不受支持的仅 XFA 表单),会抛出 EPdfError 异常。请将赋值包在 try/except 块中以便优雅处理错误,并查看 E.Message 获取 PDFium 的错误说明

备注

示例

Pdf1.FileName := 'C:\docs\report.pdf';
Pdf1.Password := ''; // leave empty if not encrypted
try
  Pdf1.Active := True;
  ShowMessage('Pages: ' + IntToStr(Pdf1.PageCount));
except
  on E: EPdfError do
    ShowMessage('Cannot open: ' + E.Message);
end;

另请参阅

FileName, Password, LoadDocument, PageCount, LoadLibrary, CreateDocument