AddLinkToImportData
Anotace a hotspotové odkazy, formulářová pole a AcroForms
Popis
Přidává na vybranou stránku klikatelný obdélník hotspotu, který při aktivaci spustí akci PDF import-data. Akce import-data naplní pole AcroForm dokumentu ze souboru Forms Data Format (FDF) na disku. Akce je definována v ISO 32000-1 §12.6.4.8, Table 198
Typické použití: odkaz “Reload sample data” nebo “Reset to defaults” v interaktivním formuláři, kde soubor FDF putuje spolu s PDF a drží kanonické hodnoty polí
Použijte funkci SetAnnotBorderColor ke změně barvy ohraničení hotspotu
Syntaxe
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);Parametry
| Left | Vodorovná souřadnice levé hrany hotspotového obdélníku |
|---|---|
| Top | Svislá souřadnice horní hrany hotspotového obdélníku |
| Width | Šířka hotspotového obdélníku |
| Height | Výška hotspotového obdélníku |
| FileName | Cesta k souboru FDF, ze kterého se naplní formulářová pole. Zpětná lomítka se převádějí na lomítka podle PDF kanonického tvaru cesty dle ISO 32000-1 §7.11.2.1. Soubor nemusí v okamžiku vytvoření PDF existovat, ale při prohlížení musí být k dispozici, aby akce uspěla |
| Options | Bitová maska řídící vzhled odkazu. Bit 0 (hodnota 1): nakreslit ohraničení kolem hotspotového obdélníku. Bity 1–3 volí režim zvýraznění při kliknutí (2 = Invert, 4 = Outline, 8 = Push); není-li nastaven žádný bit zvýraznění, použije se výchozí Invert. Stejná konvence jako u AddLinkToWeb / AddLinkToHideField |
Poznámky
Režimy PDF/A a PDF/X-6 akce ImportData odmítají a vrací 0 bez přidání anotace; vyžaduje se PDF 1.4 nebo novější