/Title را از فرهنگ اطلاعات سند PDF برمیگرداندproperty Title: WString; // read only
Title عنوان اعلامشدهٔ سند را برمیگرداند — همان رشتهای که Acrobat هنگام فعال
بودن ترجیح نمایشگر «Display document title in title bar» در نوار عنوان
برنامه نمایش میدهد. این مقدار از طریق MetaText['Title']
واکشی میشود، که FPDF_GetMetaText PDFium را روی مدخل /Title
فرهنگ اطلاعات سند فراخوانی میکند (ISO 32000-1 § 14.3.3)
اگر این مدخل وجود نداشته باشد یا کامپوننت غیرفعال باشد، ویژگی یک WString
خالی برمیگرداند. عنوان عمداً از نام پایانی فایل متمایز است: یک PDF تازهنویسیشده که
با نام quarterly-2026.pdf ذخیره شده ممکن است بهطور مشروع خود را از طریق
مدخل /Title با عنوان «Q1 2026 Financial Review» معرفی کند
این ویژگی فقطخواندنی است. تنظیم عنوان در زمان ایجاد از طریق
FPDF_SetMetaText PDFium با استفاده از هندل
Document، یا با نوشتن یک جریان فرادادهٔ 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;
// Use the document's own title for the form caption.
Caption := EffectiveTitle(Pdf1, ExtractFileName(Pdf1.FileName));