AddLinkToImportDataA
Annotationer og hotspot-links, Formularfelter og AcroForms
Beskrivelse
Det afsluttende A angiver DLL-indgangspunktet for ANSI (char); ActiveX/COM-grænsefladen eksponerer kun Unicode-formen. Funktionsmåden er identisk med AddLinkToImportData, og strengargumenter fortolkes med den aktuelle SetAnsiMode-tegntabel
Tilføjer et klikbart hotspot-rektangel på den valgte side, som udløser en PDF-import-data-handling, når det aktiveres. En import-data-handling udfylder dokumentet's 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 link til “Genindlæs eksempeldata” eller “Nulstil til standarder” 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 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);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 den FDF-fil, som formularfelterne udfyldes fra. Omvendte skråstreger konverteres til skråstreger i henhold til PDF's kanoniske stiform i ISO 32000-1 §7.11.2.1. Filen behøver ikke findes, når PDF'en oprettes, men skal være til stede ved visning, for at handlingen kan lykkes. |
| Options | Bitmaske, der styrer linkets udseende. Bit 0 (værdi 1): tegn en kant omkring hotspot-rektanglet. Bit 1–3 vælger fremhævningstilstanden ved klik (2 = Invert, 4 = Outline, 8 = Push); når ingen fremhævningsbit er angivet, bruges Invert som standard. Samme konvention som AddLinkToWeb / AddLinkToHideField. |
Bemærkninger
IKKE tilladt i PDF/A, fordi handlingen refererer til en ekstern ressource. Når dokumentet er i PDF/A-tilstand, returnerer funktionen lydløst 0, og der tilføjes ingen annotering. PDF 1.4 eller nyere er påkrævet