وثائق PDFiumPas

Subject الخاصية

يحافظ إدخال API هذا على المعرّفات والتواقيع وكتل الكود ومصطلحات PDF بصيغتها الأصلية.
المكون: TPdf  ·  الوحدة: PDFium
يعيد قيمة الإدخال /Subject من قاموس معلومات مستند PDF

الصياغة

property Subject: WString; // read only

الوصف

يعيد Subject إدخال /Subject من قاموس معلومات المستند، وهو وصف قصير حرّ الصياغة لما يدور حوله المستند. وتفوض الخاصية إلى MetaText['Subject']، الذي يستدعي FPDF_GetMetaText من PDFium لهذا المفتاح. ويُعرَّف الحقل في ISO 32000-1 § 14.3.3 إلى جانب /Title و /Author و /Keywords

عندما لا يحتوي المستند على إدخال /Subject، أو عندما لا يكون محمّلًا بعد، أو عندما يكون مرجع /Info في الـ trailer مفقودًا بالكامل، تُرجع الخاصية WString فارغة. ولا يُرفع أي استثناء

مفهوميًا يجيب /Subject عن "ما هذا المستند؟" بينما يجيب /Title عن "ما اسم هذا المستند؟". وعمليًا يترك كثير من المنتجين Subject فارغًا، لذا تعامل معه كنص إضافي اختياري لا كحقل مطلوب

ملاحظات

مثال

procedure TForm1.DumpMetadataToGrid;
begin
  Pdf1.Active := True;
  StringGrid1.Cells[0, 0] := 'Field';
  StringGrid1.Cells[1, 0] := 'Value';
  StringGrid1.Cells[0, 1] := 'Title';
  StringGrid1.Cells[1, 1] := Pdf1.Title;
  StringGrid1.Cells[0, 2] := 'Subject';
  StringGrid1.Cells[1, 2] := Pdf1.Subject;
  StringGrid1.Cells[0, 3] := 'Author';
  StringGrid1.Cells[1, 3] := Pdf1.Author;
end;

انظر أيضا

Title, Author, Keywords, Creator, MetaText