وثائق PDFiumPas

Title الخاصية

يحافظ إدخال API هذا على المعرّفات والتواقيع وكتل الكود ومصطلحات PDF بصيغتها الأصلية.
المكون: TPdf  ·  الوحدة: PDFium
يعيد قيمة الإدخال /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 عن نفسه بشكل مشروع على أنه "Q1 2026 Financial Review" عبر إدخال /Title

الخاصية للقراءة فقط. ويتم تعيين العنوان وقت الإنشاء عبر FPDF_SetMetaText في PDFium باستخدام مقبض Document، أو بكتابة دفق بيانات 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