AddLinkToSubmitForm
Annotations et liens réactifs, champs de formulaire et AcroForms
Description
Ajoute à la page sélectionnée un rectangle de zone active cliquable qui déclenche une action d’envoi de formulaire PDF lors de son activation. Une action submit-form envoie les valeurs des champs AcroForm vers une URL ou un point de traitement de formulaires, sans nécessiter 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 de la bordure 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 | Coordonnée horizontale du bord gauche du rectangle de la zone active |
|---|---|
| Top | Coordonnée verticale du bord supérieur du rectangle de la zone active |
| Width | Largeur du rectangle de la zone active |
| Height | Hauteur du rectangle de la zone active |
| URL | URL cible d’envoi stockée dans la spécification de fichier de l’action |
| FieldNames | Liste facultative de noms de champs AcroForm complets, séparés par des virgules, des points-virgules ou des sauts de ligne. Les espaces de début et de fin de chaque nom sont supprimés |
| Flags | Indicateurs de l’action d’envoi de formulaire PDF écrits dans l’entrée /Flags de l’action. Passez 0 pour une soumission au format FDF par défaut. Parmi les bits standard courants : 4 pour le format HTML, 32 pour XFDF et 256 pour envoyer le document PDF complet |
| Options | Masque de bits contrôlant l’apparence du lien. Bit 0 (valeur 1) : trace une bordure autour du rectangle de la zone active. Les bits 1-3 sélectionnent le mode de surbrillance au clic (2 = Inverser, 4 = Contour, 8 = Enfoncer) ; si aucun bit de surbrillance n’est défini, Inverser est utilisé par défaut |
Valeurs de retour
| 0 | L’action n’a pas été ajoutée : le document est en mode PDF/A, le rectangle est invalide ou URL est vide |
|---|---|
| 1 | L’annotation de lien et l’action d’envoi de formulaire ont été ajoutées |
Remarques
Le mode PDF/A bloque cette action car elle peut référencer une cible d’envoi externe. La fonction exige PDF 1.2 ou ultérieur