AddLinkToSubmitFormA
Annotations et liens réactifs, champs de formulaire et AcroForms
Description
Le A final indique le point d’entrée ANSI (char) de la DLL ; la surface ActiveX/COM n’expose que la forme Unicode. Le comportement est identique à celui de AddLinkToSubmitForm et les arguments de chaîne sont interprétés selon la page de codes SetAnsiMode actuelle
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 DLAddLinkToSubmitFormA(InstanceID: Integer; Left, Top, Width, Height: Double; URL, FieldNames: PAnsiChar; Flags, Options: Integer): Integer;DLL
int DLAddLinkToSubmitFormA(int InstanceID, double Left, double Top, double Width, double Height, const char * URL, const char * 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