AddLinkToImportData
Anotácie a aktívne odkazy, Polia formulára a AcroForms
Opis
Pridáva na vybranú stránku klikateľný obdĺžnik hotspotu, ktorý po aktivácii spustí akciu PDF import-data. Akcia import-data naplní polia AcroForm v dokumente údajmi zo súboru Forms Data Format (FDF) na disku. Akcia je definovaná v ISO 32000-1 §12.6.4.8, Table 198.
Typické použitie: odkaz “Reload sample data” alebo “Reset to defaults” v interaktívnom formulári, kde je súbor FDF uložený spolu s PDF a obsahuje kanonické hodnoty polí.
Na zmenu farby okraja hotspotu použite funkciu SetAnnotBorderColor.
Syntax
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);Parametre
| Left | Horizontálna súradnica ľavého okraja obdĺžnika hotspotu |
|---|---|
| Top | Zvislá súradnica horného okraja obdĺžnika hotspotu |
| Width | Šírka obdĺžnika hotspotu |
| Height | Výška obdĺžnika hotspotu |
| FileName | Cesta k súboru FDF, z ktorého sa naplnia polia formulára. Spätné lomky sa podľa ISO 32000-1 §7.11.2.1 menia na lomky vpred v kánonickom tvare cesty PDF. Súbor nemusí existovať v čase vytvorenia PDF, ale musí byť prítomný v čase zobrazenia, aby akcia uspela. |
| Options | Bitová maska riadiaca vzhľad odkazu. Bit 0 (hodnota 1): nakresliť orámovanie okolo obdĺžnika hotspotu. Bity 1–3 vyberajú režim zvýraznenia pri kliknutí (2 = Invert, 4 = Outline, 8 = Push); keď nie je nastavený žiadny bit zvýraznenia, predvolene sa použije Invert. Rovnaká konvencia ako AddLinkToWeb / AddLinkToHideField. |
Poznámky
V PDF/A nie je povolená, pretože akcia odkazuje na externý zdroj. Keď je dokument v režime PDF/A, funkcia potichu vráti 0 a nepridá sa žiadna anotácia. Vyžaduje sa PDF 1.4 alebo novší.