AddLinkToImportData

Opombe in interaktivne povezave, Polja obrazcev in AcroForms

Opis

Doda klikljiv pravokotnik aktivne točke na izbrano stran, ki ob aktivaciji sproži dejanje PDF import-data. Dejanje import-data napolni polja AcroForm v dokumentu iz datoteke Forms Data Format (FDF) na disku. Dejanje je opredeljeno v ISO 32000-1 §12.6.4.8, Table 198.

Običajna raba: povezava “Reload sample data” ali “Reset to defaults” v interaktivnem obrazcu, kjer je datoteka FDF shranjena ob PDF-ju in vsebuje kanonične vrednosti polj.

Za spremembo barve roba aktivne točke uporabite funkcijo SetAnnotBorderColor.

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 levega roba pravokotnika aktivne točke
Top	Navpična koordinata zgornjega roba pravokotnika aktivne točke
Width	Širina pravokotnika aktivne točke
Height	Višina pravokotnika aktivne točke
FileName	Pot do datoteke FDF, iz katere bodo izpolnjena polja obrazca. Po ISO 32000-1 §7.11.2.1 se poševnice nazaj pretvorijo v poševnice naprej v obliki kanonične poti PDF. Datoteka ob ustvarjanju PDF-ja ni nujno prisotna, vendar mora biti ob ogledu na voljo, da dejanje uspe.
Options	Bitna maska, ki nadzoruje videz povezave. Bit 0 (vrednost 1): nariše rob okoli pravokotnika aktivne točke. Biti 1–3 izberejo način poudarjanja ob kliku (2 = Invert, 4 = Outline, 8 = Push); kadar ni nastavljen noben bit za poudarjanje, je privzeta vrednost Invert. Enaka konvencija kot AddLinkToWeb / AddLinkToHideField.

Opombe

NI dovoljeno v PDF/A, ker dejanje sklicuje na zunanji vir. Ko je dokument v načinu PDF/A, funkcija tiho vrne 0 in nobena opomba ni dodana. Zahtevana je PDF 1.4 ali novejša različica.