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
| Left | Den horisontale koordinaten for venstre kant av det aktive rektanglet |
|---|---|
| Top | Den vertikale koordinaten for øvre kant av det aktive rektanglet |
| Width | Bredden på det aktive rektanglet |
| Height | Høyden på det aktive rektanglet |
| FileName | Stien 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 |
| Options | Bitmaske 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