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

LeftCoordonata orizontală a marginii stângi a dreptunghiului hotspot
TopCoordonata verticală a marginii superioare a dreptunghiului hotspot
WidthLățimea dreptunghiului hotspot
HeightÎnălțimea dreptunghiului hotspot
URLURL-ul țintă de trimitere stocat în specificația fișierului acțiunii
FieldNamesListă 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
FlagsIndicatoare 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
OptionsMască 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ă

0Acțiunea nu a fost adăugată deoarece documentul este în modul PDF/A, dreptunghiul este invalid sau URL este gol
1Adnotarea 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ă