AddLinkToSubmitForm

Annotations et liens interactifs, Champs de formulaire et AcroForms

Description

Ajoute un rectangle de zone active cliquable à la page sélectionnée, qui déclenche une action de soumission de formulaire PDF lors de son activation. Une action de soumission envoie les valeurs des champs AcroForm à une URL ou un point de traitement de formulaire sans recourir à JavaScript

Utilisez FieldNames pour restreindre les champs soumis. Laissez FieldNames vide pour que la visionneuse soumette tous les champs applicables

Utilisez la fonction SetAnnotBorderColor pour modifier la couleur du bord de la zone active

Syntaxe

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);

Paramètres

Left	La coordonnée horizontale du bord gauche du rectangle de zone active
Top	La coordonnée verticale du bord supérieur du rectangle de zone active
Width	La largeur du rectangle de zone active
Height	La hauteur du rectangle de zone active
URL	L'URL cible de soumission stockée dans la spécification de fichier de l'action
FieldNames	Liste optionnelle de noms de champs AcroForm complets, séparés par des virgules, des points-virgules ou des sauts de ligne. Les espaces en début et en fin de chaque nom sont supprimés
Flags	Indicateurs de l'action de soumission de formulaire PDF écrits dans l'entrée `/Flags` de l'action. Passez 0 pour la soumission par défaut au format FDF. Les bits standard courants incluent 4 pour le format HTML, 32 pour XFDF, et 256 pour soumettre le document PDF complet
Options	Masque de bits contrôlant l'apparence du lien. Bit 0 (valeur 1) : dessine un bord autour du rectangle de zone active. Les bits 1 à 3 sélectionnent le mode de mise en évidence au clic (2 = Inverser, 4 = Contour, 8 = Appuyer) ; si aucun bit de mise en évidence n'est défini, Inverser est utilisé par défaut

Valeurs de retour

0	L'action n'a pas été ajoutée car le document est en mode PDF/A, le rectangle est invalide, ou `URL` est vide
1	L'annotation de lien et l'action de soumission de formulaire ont été ajoutées

Remarques

Le mode PDF/A bloque cette action car elle peut référencer une cible de soumission externe. La fonction requiert PDF 1.2 ou une version ultérieure