AttachmentCount - TPdf - PDFium Delphi Component

Komponenta: TPdf · Jedinica: PDFium

Broj ugrađenih privitaka datoteka navedenih u dokumentu

Sintaksa

property AttachmentCount: Integer; // read only

Opis

AttachmentCount numerira tokove ugrađenih datoteka dostupne kroz stablo naziva kataloga /Names /EmbeddedFiles (PDF 1.7 specifikacija, odjeljak 7.11). To su proizvoljne datoteke (XML, proračunske tablice, izvorni CAD, potpisani XML, ZIP arhive,…) zapakirane unutar PDF-a koje preglednici izlažu kao bočnu traku “Privici”. PDF/A-3 posebno zahtijeva da se svaki relevantni izvorni artefakt ugradi na ovaj način radi dugoročne reproducibilnosti

Vrijednost je 0 kada je Active False i kada dokument ne nosi ugrađene datoteke. Anotacije privitka datoteke (podvrsta /FileAttachment) ovdje se ne broje — to su anotacije na razini stranice i pojavljuju se kroz AnnotationCount. PDFium Delphi Component izlaže ugrađene tokove kao TBytes putem Attachment[Index]; čitljivo ime datoteke i MIME-stilu slična vrsta dostupni su kroz AttachmentName[Index] i AttachmentType[Index]

Tipična petlja jest for I := 0 to Pdf.AttachmentCount - 1 do. Svaki pristup Attachment[I] dekomprimira tok ugrađene datoteke u memoriju, pa pohranite TBytes u predmemoriju ako ga trebate zapisati na disk i predati raščlanjivaču. Dodavanje ili uklanjanje privitka poništava indekse — nakon izmjene ponovno pročitajte AttachmentCount

Napomene

Korisno za arhivske tijekove rada: preglednici PDF/A-3 obično izlažu privitke kao kanonske izvorne podatke za vidljivi PDF izvještaj
Sigurnosna napomena: privici mogu biti proizvoljni izvršni formati. Tretirajte njihov sadržaj kao nepouzdani unos kada ih izdvajate
Kombinirajte s FeatureSupported(feAttachment) za otkrivanje podržava li instalirana PDFium izgradnja mijenjanje naziva privitaka

Primjer

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;

Vidi također