AddLinkToImportData

Annotasjoner og hotspot-lenker, skjemafelter og AcroForms

Beskrivelse

Legger et klikkbart hotspot-rektangel til den valgte siden som utløser en PDF import-data-handling ved aktivering. En import-data-handling fyller dokumentets AcroForm-felter fra en Forms Data Format (FDF)-fil på disken. Handlingen er definert i ISO 32000-1 §12.6.4.8, Table 198

Typisk bruk: en “Reload sample data” eller “Reset to defaults”-lenke i et interaktivt skjema, der FDF-filen følger med PDF-en og holder de kanoniske feltverdiene

Bruk funksjonen SetAnnotBorderColor for å endre fargen 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);

Parametere

Left	Den horisontale koordinaten til hotspot-rektangelets venstre kant
Top	Den vertikale koordinaten til hotspot-rektangelets øvre kant
Width	Bredden på hotspot-rektangelet
Height	Høyden på hotspot-rektangelet
FileName	Stien til FDF-filen som skjemafeltene fylles fra. Omvendte skråstreker konverteres til vanlige skråstreker i henhold til ISO 32000-1 §7.11.2.1, PDF-kanonisk stiform. Filen trenger ikke finnes ved oppretting av PDF-en, men må være til stede ved visning for at handlingen skal lykkes.
Options	Bitmaske som styrer lenkeutseendet. Bit 0 (verdi 1): tegn en ramme rundt hotspot-rektangelet. Bit 1–3 velger klikkuthevingsmodus (2 = Invert, 4 = Outline, 8 = Push); når ingen uthevingsbit er satt, brukes Invert som standard. Samme konvensjon som AddLinkToWeb / AddLinkToHideField.

Merknader

PDF/A- og PDF/X-6-moduser avviser ImportData-handlinger og returnerer 0 uten å legge til en annotasjon; PDF 1.4 eller nyere kreves