PDFiumPas 文档

Title 属性

此 API 条目保留标识符、签名、代码块和 PDF 术语的原始形式。
组件: TPdf  ·  单元: PDFium
返回 PDF 文档信息字典中 /Title 条目的值

语法

property Title: WString; // read only

说明

Title 返回文档声明的标题,也就是在设置了 "Display document title in title bar" 查看器首选项时 Acrobat 显示在应用程序标题栏中的同一字符串。该值通过 MetaText['Title'] 取得,后者会针对文档信息字典的 /Title 条目调用 PDFium 的 FPDF_GetMetaText(ISO 32000-1 § 14.3.3)

如果该条目缺失或组件未激活,此属性返回空 WString。标题与文件的基础名称有意保持不同:新创建并保存为 quarterly-2026.pdf 的 PDF 完全可以通过 /Title 条目把自己声明为 "Q1 2026 Financial Review"

此属性为只读。若要在创建时设置标题,可以通过使用 Document 句柄调用 PDFium 的 FPDF_SetMetaText 来完成,也可以写入 XMP 元数据流(dc:title

备注

示例

function EffectiveTitle(Pdf1: TPdf; const Fallback: string): string;
begin
  if not Pdf1.Active then
    Pdf1.Active := True;
  Result := Trim(Pdf1.Title);
  if Result = '' then
    Result := Fallback;
end;

// 使用文档自身的标题作为窗体标题
Caption := EffectiveTitle(Pdf1, ExtractFileName(Pdf1.FileName));

另请参阅

Author, Subject, Keywords, MetaText, CreationDate, Active