PDFium Delphi Component Docs

ImportXFDF metoda

Komponenta: TPdf  ·  Jedinica: PDFium
Čita XFDF (ISO 19444-1) dokument i primjenjuje njegove vrijednosti polja obrasca i anotacije na učitani PDF, stvarajući anotacije na odgovarajućim stranicama i zapisujući vrijednosti polja u njihove widget anotacije

Sintaksa

function ImportXFDF(const FileName: string): Integer; overload;
function ImportXFDF(Stream: TStream): Integer; overload;

Opis

ImportXFDF raščlanjuje XFDF XML dokument i primjenjuje njegove odjeljke <fields> i <annots> na trenutačno učitani PDF

Za svaki element <field> kvalificirani naziv (s točkama) uspoređuje se s widget anotacijama u dokumentu, a vrijednost se zapisuje u unos /V polja. Za polja checkboxa i radio gumba priložena izvozna vrijednost koristi se za odabir odgovarajućeg appearancea uključenog stanja, pa se polje renderira kao označeno

Izričito prazan <value> briše odgovarajuće polje, dok izostavljena vrijednost ostavlja polje nepromijenjenim; duboko ugniježđeni nazivi polja s točkama zadržavaju punu hijerarhiju

Za svaki element anotacije nova anotacija stvara se na stranici koju označava atribut page (s početkom od nule). Nakon stvaranja uvoznik ispunjava Contents, Author (title), Name (NM), Subject, ModificationDate, CreationDate, Icon i zastavice anotacije iz odgovarajućih XFDF atributa

Vraća ukupan broj obrađenih polja i anotacija

Uvoz anotacija primjenjuje RGB boje i boje unutrašnjosti, čuva izričito prazna tekstualna polja, raščlanjuje decimalne koordinate neovisno o regionalnim postavkama procesa i obnavlja sve četverokute markupa iz atributa coords

Skener prihvaća elemente i atribute s prefiksima imenskih prostora, mješovite tekstualne i CDATA čvorove, XML reference entiteta te sadržaj polja ili anotacija u kojem su razmaci značajni; nevaljane numeričke reference Unicode skalara odbijaju XFDF ulaz

Izostavljeni element contents anotacije ostavlja sadržaj nove anotacije praznim, dok izričito prazan element zapisuje praznu vrijednost

Atribut rect obavezan je za svaku anotaciju: ako nedostaje, anotacija se preskače umjesto da se stvori s pravokutnikom nulte veličine

Raščlanjivanje obavlja ručno napisani XML skener, a ne cijeli XML DOM, pa ImportXFDF ne uvodi ovisnost o XML DOM-u

Napomene

Primjer

// Import field values and annotations from an .xfdf file
Imported := Pdf1.ImportXFDF('C:\Data\form.xfdf');
Pdf1.SaveAs('C:\Data\form_filled.pdf');

Vidi također

ExportXFDF, CreateAnnotation, Annotation, FormFieldInfo