/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)
True 才会得到非空结果。即使在未激活时调用此属性也很安全,它只会返回空字符串WString 都包含正确解码的文本/Title 和 XMP 中的 dc:title 保持一致。如果你编写 PDF/A 文档,请同时通过这两个入口设置标题,并在往返保存后验证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));