AddLinkToImportData

Annoteringer og hotspot-links, formularfelter og AcroForms

Beskrivelse

Tilføjer et klikbart hotspot-rektangel til den valgte side, som udløser en PDF import-data-handling ved aktivering. En import-data-handling udfylder dokumentets AcroForm-felter fra en Forms Data Format-fil (FDF) på disken. Handlingen er defineret i ISO 32000-1 §12.6.4.8, Table 198.

Typisk brug: et “Genindlæs eksempeldata”- eller “Nulstil til standardværdier”-link i en interaktiv formular, hvor FDF-filen leveres sammen med PDF'en og indeholder de kanoniske feltværdier.

Brug funktionen SetAnnotBorderColor til at ændre farven på hotspot-kanten.

Syntaks

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);

Parametre

Left	Den vandrette koordinat for hotspot-rektanglets venstre kant
Top	Den lodrette koordinat for hotspot-rektanglets øverste kant
Width	Bredden af hotspot-rektanglet
Height	Højden af hotspot-rektanglet
FileName	Stien til FDF-filen, hvorfra formularfelterne udfyldes. Omvendte skråstreger konverteres til skråstreger i henhold til ISO 32000-1 §7.11.2.1 PDF-kanonisk stil. Filen behøver ikke at findes ved PDF-oprettelsestidspunktet, men skal være til stede ved visningstidspunktet, for at handlingen kan lykkes.
Options	Bitmaske, der styrer linkets udseende. Bit 0 (værdi 1): tegn en kant rundt om hotspot-rektanglet. Bit 1–3 vælger klikfremhævningstilstanden (2 = Invert, 4 = Outline, 8 = Push); når ingen fremhævningsbit er sat, bruges Invert som standard. Samme konvention som AddLinkToWeb / AddLinkToHideField.

Bemærkninger

PDF/A- og PDF/X-6-tilstandene afviser ImportData-handlinger og returnerer 0 uden at tilføje en annotering; PDF 1.4 eller senere er påkrævet