AddLinkToImportData
Adnotări și legături hotspot, câmpuri de formular și AcroForms
Descriere
Adaugă un dreptunghi hotspot clicabil pe pagina selectată, care declanșează o acțiune PDF import-data la activare. O acțiune import-data populează câmpurile AcroForm ale documentului dintr-un fișier Forms Data Format (FDF) aflat pe disc. Acțiunea este definită în ISO 32000-1 §12.6.4.8, Table 198Utilizare tipică: o legătură “Reîncarcă datele exemplu” sau “Revenire la valorile implicite” într-un formular interactiv, unde fișierul FDF este livrat alături de PDF și conține valorile canonice ale câmpurilorFolosiți funcția SetAnnotBorderColor pentru a schimba culoarea chenarului zonei hotspot
Utilizare tipică: un link “Reîncarcă datele exemplu” sau “Revenire la valorile implicite” într-un formular interactiv, unde fișierul FDF însoțește PDF-ul și conține valorile canonice ale câmpurilor
Folosiți funcția SetAnnotBorderColor pentru a schimba culoarea chenarului hotspot.
Sintaxă
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);Parametri
| Left | Coordonata orizontală a marginii stângi a dreptunghiului hotspot |
|---|---|
| Top | Coordonata verticală a marginii superioare a dreptunghiului hotspot |
| Width | Lățimea dreptunghiului hotspot |
| Height | Înălțimea dreptunghiului hotspot |
| FileName | Calea către fișierul FDF din care vor fi populate câmpurile de formular. Barele oblice inverse sunt convertite în bare oblice normale, conform formei canonice de cale PDF din ISO 32000-1 §7.11.2.1. Fișierul nu trebuie să existe la momentul creării PDF-ului, dar trebuie să fie prezent la momentul vizualizării pentru ca acțiunea să reușească. |
| Options | Mască de biți care controlează aspectul legăturii. Bitul 0 (valoarea 1): desenează un chenar în jurul dreptunghiului hotspot. Biții 1–3 selectează modul de evidențiere la clic (2 = Invert, 4 = Outline, 8 = Push); când niciun bit de evidențiere nu este activat, Invert este folosit ca implicit. Aceeași convenție ca AddLinkToWeb / AddLinkToHideField. |
Observații
Modurile PDF/A și PDF/X-6 resping acțiunile ImportData și returnează 0 fără a adăuga o adnotare; este necesar PDF 1.4 sau ulterior