AddLinkToImportData
Anotácie a hotspotové odkazy, formulárové polia a AcroForms
Popis
Na vybranú stránku pridá klikateľný obdĺžnik hotspotu, ktorý po aktivácii spustí akciu import-data v PDF. Akcia import-data vyplní polia AcroForm dokumentu 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 “Znovu načítať vzorové dáta” alebo “Obnoviť predvolené” v interaktívnom formulári, kde sa súbor FDF dodáva spolu s PDF a obsahuje kanonické hodnoty políFarbu okraja hotspotu možno zmeniť funkciou SetAnnotBorderColor
Použite funkciu SetAnnotBorderColor na zmenu farby rámca hotspotu.
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 | Vodorovná 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 vyplnia formulárové polia. Spätné lomky sa prevedú na obyčajné lomky podľa kanonickej formy cesty PDF podľa ISO 32000-1 §7.11.2.1. Súbor nemusí existovať v čase vytvárania PDF, ale pri prezeraní musí byť prítomný, aby akcia uspela |
| Options | Bitová maska riadiaca vzhľad odkazu. Bit 0 (hodnota 1): nakresliť okolo obdĺžnika hotspotu okraj. Bity 1–3 vyberajú režim zvýraznenia pri kliknutí (2 = Invert, 4 = Outline, 8 = Push); keď nie je nastavený žiadny bit zvýraznenia, použije sa predvolené Invert. Rovnaká konvencia ako pri AddLinkToWeb / AddLinkToHideField |
Poznámky
Režimy PDF/A a PDF/X-6 akcie ImportData zamietnu a vrátia 0 bez pridania anotácie; vyžaduje sa PDF 1.4 alebo novší