AddLinkToImportDataA

Annotasjoner og hotspot-lenker, skjemafelter og AcroForms

Beskrivelse

Den avsluttende A angir ANSI-inngangspunktet (char) i DLL-en; ActiveX/COM-flaten eksponerer kun Unicode-formen. Oppførselen er identisk med AddLinkToImportData og strengargumenter tolkes ut fra gjeldende kodetabell i SetAnsiMode

Legger til et klikkbart hotspot-rektangel på den valgte siden som utløser en PDF import-data-handling ved aktivering. En import-data-handling fyller dokumentets AcroForm-felt fra en Forms Data Format (FDF)-fil på disk. 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 inneholder de kanoniske feltverdiene

Bruk SetAnnotBorderColor-funksjonen for å endre fargen på hotspot-kanten

Syntaks

Delphi

Function DLAddLinkToImportDataA(InstanceID: Integer; Left, Top, Width, Height: Double; FileName: PAnsiChar; Options: Integer): Integer;

DLL

int DLAddLinkToImportDataA(int InstanceID, double Left, double Top, double Width, double Height, const char * FileName, int Options);

Parametere

LeftDen horisontale koordinaten for venstre kant av det aktive rektanglet
TopDen vertikale koordinaten for øvre kant av det aktive rektanglet
WidthBredden på det aktive rektanglet
HeightHøyden på det aktive rektanglet
FileNameStien til FDF-filen skjemafeltene skal fylles fra. Backslashes konverteres til skråstreker iht. ISO 32000-1 §7.11.2.1 PDF-kanonisk skjema. Filen trenger ikke finnes ved PDF-opprettingstidspunktet men må være til stede ved visningstidspunktet for at handlingen skal lykkes
OptionsBitmaske som styrer lenkeutseendet. Bit 0 (verdi 1): tegn en kant 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

IKKE tillatt i PDF/A fordi handlingen refererer til en ekstern ressurs. Når dokumentet er i PDF/A-modus, returnerer funksjonen stille 0, og ingen annotasjon legges til. PDF 1.4 eller nyere kreves