PDFium Delphi Component Docs

AttachmentCount властивість

Component: TPdf  ·  Unit: 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