وثائق PDFiumPas

AttachmentCount الخاصية

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

الصياغة

property AttachmentCount: Integer; // read only

الوصف

تعد AttachmentCount تعدادا لتدفقات الملفات المضمنة التي يمكن الوصول إليها عبر شجرة الأسماء /Names /EmbeddedFiles في الكتالوج، وفقا للقسم 7.11 من مواصفة PDF 1.7. وهذه ملفات عشوائية مثل XML وجداول البيانات وملفات CAD المصدرية وXML الموقعة وأرشيفات ZIP وغيرها، تُحزم داخل PDF ويعرضها العارضون في الشريط الجانبي "Attachments". وتفرض PDF/A-3 تحديدا تضمين كل عنصر مصدر ذي صلة بهذه الطريقة لضمان قابلية إعادة الإنتاج على المدى الطويل

تكون القيمة 0 عندما تكون Active False وعندما لا يحمل المستند أي ملفات مضمنة. أما تعليقات مرفقات الملفات، من النوع /FileAttachment، فلا تُحتسب هنا؛ فهي تعليقات على مستوى الصفحة وتظهر عبر AnnotationCount بدلا من ذلك. يعرض PDFiumPas التدفقات المضمنة على شكل TBytes عبر Attachment[Index]؛ كما يتوفر اسم الملف المقروء بشريا ونوعه على نمط MIME عبر AttachmentName[Index] وAttachmentType[Index]

الحلقة المعتادة هي for I := 0 to Pdf.AttachmentCount - 1 do. كل وصول إلى Attachment[I] يفك ضغط تدفق الملف المضمن إلى الذاكرة، لذا خزّن TBytes إذا كنت تحتاج إلى كتابته إلى القرص وتمريره إلى محلل. إن إضافة مرفق أو إزالته تبطل الفهارس — أعد قراءة AttachmentCount بعد أي تعديل

ملاحظات

مثال

var I: Integer;
var Data: TBytes;
for I := 0 to Pdf1.AttachmentCount - 1 do
begin
  Data := Pdf1.Attachment[I];
  TFile.WriteAllBytes(Pdf1.AttachmentName[I], Data);
end;

انظر أيضا

Attachment, AttachmentName, AttachmentType, AnnotationCount