PDFium Delphi Component Docs

AttachmentCount ویژگی

کامپوننت: TPdf  ·  واحد: PDFium
شمار پیوست‌های فایل جاسازی‌شدهٔ اعلام‌شده در سند

Syntax

property AttachmentCount: Integer; // read only

Description

AttachmentCount جریان‌های فایل جاسازی‌شده را که از طریق درخت نام /Names /EmbeddedFiles کاتالوگ قابل دسترسی‌اند شمارش می‌کند (بخش 7.11 مشخصات PDF 1.7). این‌ها فایل‌های دلخواه (XML، صفحات گسترده، CAD منبع، XML امضاشده، آرشیوهای ZIP و…) هستند که داخل PDF بسته‌بندی شده و توسط نمایشگرها به‌عنوان نوار کناری “Attachments” نمایش داده می‌شوند. PDF/A-3 به‌طور خاص الزام می‌کند هر مصنوع منبع مرتبط برای بازتولیدپذیری بلندمدت به این شیوه جاسازی شود.

مقدار 0 است وقتی Active مقدار False باشد و وقتی سند فایل جاسازی‌شده‌ای ندارد. حاشیه‌نویسی‌های پیوست فایل (زیرنوع /FileAttachment) اینجا شمرده نمی‌شوند — آن‌ها حاشیه‌نویسی سطح صفحه‌اند و در عوض از طریق AnnotationCount ظاهر می‌شوند. PDFium Delphi Component جریان‌های جاسازی‌شده را به‌صورت TBytes از طریق Attachment[Index] ارائه می‌کند؛ نام فایل خوانا برای انسان و نوع به سبک MIME از طریق AttachmentName[Index] و AttachmentType[Index] در دسترس‌اند

حلقهٔ معمول for I := 0 to Pdf.AttachmentCount - 1 do است. هر دسترسی به Attachment[I] جریان فایل جاسازی‌شده را در حافظه از حالت فشرده بیرون می‌آورد، پس اگر لازم است آن را روی دیسک بنویسید و به یک تجزیه‌گر بدهید، TBytes را ذخیره کنید. افزودن یا حذف یک پیوست نمایه‌ها را بی‌اعتبار می‌کند — پس از تغییر، AttachmentCount را دوباره بخوانید

Remarks

Example

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;

See Also

Attachment, AttachmentName, AttachmentType, AnnotationCount