AddLinkToImportData

Anotacije i hotspot poveznice, Polja obrasca i AcroForms

Opis

Dodaje klikabilni pravokutnik aktivnog područja na odabranu stranicu koji pri aktiviranju pokreće PDF akciju za uvoz podataka. Akcija za uvoz podataka popunjava polja AcroForm dokumenta iz Forms Data Format (FDF) datoteke na disku. Akcija je definirana u ISO 32000-1 §12.6.4.8, Table 198

Tipična uporaba: poveznica “Ponovno učitaj uzorke podataka” ili “Vrati na zadane vrijednosti” u interaktivnom obrascu, gdje FDF datoteka dolazi uz PDF i sadrži kanonske vrijednosti polja

Upotrijebite funkciju SetAnnotBorderColor za promjenu boje obruba aktivnog područja

Sintaksa

Delphi

Function TPDFlib.AddLinkToImportData(Left, Top, Width, Height: Double; Const FileName: WideString; Options: Integer): Integer;

DLL

int DLAddLinkToImportData(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FileName, int Options);

Parametri

Left	Vodoravna koordinata lijevog ruba pravokutnika aktivnog područja
Top	Okomita koordinata gornjeg ruba pravokutnika aktivnog područja
Width	Širina pravokutnika aktivnog područja
Height	Visina pravokutnika aktivnog područja
FileName	Putanja do FDF datoteke iz koje će se popuniti polja obrasca. Obrnute kose crte pretvaraju se u ukošene crte prema ISO 32000-1 §7.11.2.1 obliku kanonske PDF putanje. Datoteka ne mora postojati u trenutku izrade PDF-a, ali mora biti prisutna u trenutku pregledavanja da bi akcija uspjela
Options	Bitmaska koja upravlja izgledom poveznice. Bit 0 (vrijednost 1): iscrtaj obrub oko pravokutnika aktivnog područja. Bitovi 1–3 biraju način isticanja pri kliku (2 = Invert, 4 = Outline, 8 = Push); kada nije postavljen nijedan bit isticanja, kao zadana vrijednost koristi se Invert. Ista konvencija kao AddLinkToWeb / AddLinkToHideField

Napomene

Nije dopušteno u PDF/A jer akcija upućuje na vanjski resurs. Kada je dokument u PDF/A načinu rada, funkcija tiho vraća 0 i nikakva se anotacija ne dodaje. Potreban je PDF 1.4 ili noviji