AddLinkToSubmitForm

Annotazioni e link hotspot, Campi modulo e AcroForms

Descrizione

Aggiunge un rettangolo hotspot cliccabile alla pagina selezionata che attiva un'azione PDF di invio modulo quando viene attivato; un'azione di invio modulo invia i valori dei campi AcroForm a un URL o a un endpoint di elaborazione moduli senza richiedere JavaScript

Usare FieldNames per limitare i campi inviati. Lasciare FieldNames vuoto per consentire al visualizzatore di inviare tutti i campi applicabili

Usare la funzione SetAnnotBorderColor per cambiare il colore del bordo dell'hotspot

Sintassi

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

LeftLa coordinata orizzontale del bordo sinistro del rettangolo hotspot
TopLa coordinata verticale del bordo superiore del rettangolo hotspot
WidthLa larghezza del rettangolo hotspot
HeightL'altezza del rettangolo hotspot
URLL'URL di destinazione dell'invio memorizzato nella specifica del file dell'azione
FieldNamesElenco facoltativo di nomi completi di campi AcroForm separati da virgole, punti e virgola o a capo. Gli spazi iniziali e finali intorno a ciascun nome vengono rimossi
FlagsFlag dell'azione PDF di invio modulo scritti nell'elemento /Flags dell'azione. Passare 0 per l'invio predefinito in stile FDF. I bit standard comuni includono 4 per il formato HTML, 32 per XFDF e 256 per inviare il documento PDF completo
OptionsMaschera di bit che controlla l'aspetto del link. Bit 0 (valore 1): disegna un bordo attorno al rettangolo hotspot. I bit 1-3 selezionano la modalità di evidenziazione al clic (2 = Inverti, 4 = Contorno, 8 = Push); se nessun bit di evidenziazione è impostato, viene usato Inverti come predefinito

Valori restituiti

0L'azione non è stata aggiunta perché il documento è in modalità PDF/A, il rettangolo non è valido o URL è vuoto
1L'annotazione di link e l'azione di invio modulo sono state aggiunte

Note

La modalità PDF/A blocca questa azione perché può fare riferimento a un target di invio esterno; la funzione richiede PDF 1.2 o versione successiva