AddLinkToSubmitForm
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 de trimitere a formularului când este activat. O acțiune de trimitere a formularului trimite valorile câmpurilor AcroForm la un URL sau un punct de procesare a formularului fără a necesita JavaScript
Utilizați FieldNames pentru a restricționa câmpurile trimise. Lăsați FieldNames gol pentru a permite vizualizatorului să trimită toate câmpurile aplicabile
Utilizați funcția SetAnnotBorderColor pentru a schimba culoarea bordurii hotspot
Sintaxă
Delphi
Function TPDFlib.AddLinkToSubmitForm(Left, Top, Width, Height: Double; Const URL, FieldNames: WideString; Flags, Options: Integer): Integer;
DLL
int DLAddLinkToSubmitForm(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * URL, const wchar_t * FieldNames, int Flags, 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 |
| URL | URL-ul țintă de trimitere stocat în specificația fișierului acțiunii |
| FieldNames | Listă opțională de nume complet calificate ale câmpurilor AcroForm, separate prin virgule, punct și virgulă sau întreruperi de linie. Spațiile albe de la începutul și sfârșitul fiecărui nume sunt eliminate |
| Flags | Indicatoare ale acțiunii PDF de trimitere a formularului scrise în intrarea /Flags a acțiunii. Transmiteți 0 pentru trimiterea implicită în stil FDF. Biții standard comuni includ 4 pentru formatul HTML, 32 pentru XFDF și 256 pentru trimiterea documentului PDF complet |
| Options | Mască de biți care controlează aspectul legăturii. Bitul 0 (valoarea 1): desenează o bordură în jurul dreptunghiului hotspot. Biții 1-3 selectează modul de evidențiere la clic (2 = Invert, 4 = Outline, 8 = Push); când nu este setat niciun bit de evidențiere, Invert este folosit ca implicit |
Valoare returnată
| 0 | Acțiunea nu a fost adăugată deoarece documentul este în modul PDF/A, dreptunghiul este invalid sau URL este gol |
|---|---|
| 1 | Adnotarea de legătură și acțiunea de trimitere a formularului au fost adăugate |
Note
Modul PDF/A blochează această acțiune deoarece poate face referire la o țintă externă de trimitere. Funcția necesită PDF 1.2 sau o versiune ulterioară