AddLinkToImportData

Merkinnät ja hotspot-linkit, lomakekentät ja AcroForm-lomakkeet

Kuvaus

Lisää valitulle sivulle napsautettavan hotspot-suorakulmion, joka käynnistää PDF ImportData-toiminnon aktivoinnin yhteydessä. ImportData-toiminto täyttää asiakirjan AcroForm-kentät levyllä olevan Forms Data Format -tiedoston (FDF) tiedoilla. Toiminto on määritelty standardissa ISO 32000-1 §12.6.4.8, Table 198Tyypillinen käyttötarkoitus: “Lataa esimerkkidata uudelleen” tai “Palauta oletusarvot” -linkki interaktiivisessa lomakkeessa, jossa FDF-tiedosto toimitetaan PDF-tiedoston mukana ja sisältää kanoniset kenttäarvotHotspot-reunuksen väriä voi muuttaa SetAnnotBorderColor-funktiolla

Tyypillinen käyttö: “Reload sample data”- tai “Reset to defaults”-linkki interaktiivisessa lomakkeessa, jossa FDF-tiedosto toimitetaan PDF:n mukana ja sisältää kanoniset kenttäarvot.

Käytä SetAnnotBorderColor-funktiota muuttamaan hotspot-reunuksen väriä.

Syntaksi

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

Parametrit

Left	Hotspot-suorakulmion vasemman reunan vaakakoordinaatti
Top	Hotspot-suorakulmion yläreunan pystykoordinaatti
Width	Hotspot-suorakulmion leveys
Height	Hotspot-suorakulmion korkeus
FileName	Polku FDF-tiedostoon, jonka perusteella lomakekentät täytetään. Kenoviivat muunnetaan kauttaviivoiksi ISO 32000-1 §7.11.2.1 mukaiseen PDF-kanoniseen polkumuotoon. Tiedoston ei tarvitse olla olemassa PDF-tiedostoa luotaessa, mutta sen on oltava olemassa katseluhetkellä, jotta toiminto onnistuu.
Options	Bittimaski, joka ohjaa linkin ulkonäköä. Bitti 0 (arvo 1): piirrä reunus hotspot-suorakulmion ympärille. Bitit 1–3 valitsevat napsautuksen korostustilan (2 = Invert, 4 = Outline, 8 = Push); jos yhtään korostusbittiä ei ole asetettu, käytetään oletuksena Invert-tilaa. Sama käytäntö kuin AddLinkToWeb- ja AddLinkToHideField-funktioissa.

Huomautukset

PDF/A- ja PDF/X-6-tilat hylkäävät ImportData-toiminnot ja palauttavat arvon 0 lisäämättä merkintää; vaaditaan PDF 1.4 tai uudempi