AddLinkToResetFormA
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 AddLinkToResetForm 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 qui déclenche une action de réinitialisation de formulaire PDF lors de son activation. Une action reset-form restaure les champs AcroForm à leurs valeurs par défaut, sans nécessiter JavaScript
Utilisez FieldNames pour restreindre les champs concernés par l’action de réinitialisation. Laissez FieldNames vide pour que la visionneuse réinitialise tous les champs applicables
Utilisez la fonction SetAnnotBorderColor pour modifier la couleur de la bordure de la zone active
Syntaxe
Delphi
Function DLAddLinkToResetFormA(InstanceID: Integer; Left, Top, Width, Height: Double; FieldNames: PAnsiChar; Flags, Options: Integer): Integer;
DLL
int DLAddLinkToResetFormA(int InstanceID, double Left, double Top, double Width, double Height, 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 |
| 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 de réinitialisation de formulaire PDF écrits dans l’entrée /Flags de l’action. Passez 0 pour le comportement par défaut. Les visionneuses standard combinent les bits d’indicateur avec /Fields pour déterminer si la liste est inclusive ou exclusive |
| 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 ou le rectangle est invalide |
|---|---|
| 1 | L’annotation de lien et l’action de réinitialisation de formulaire ont été ajoutées |
Remarques
Le mode PDF/A bloque cette action car les actions de formulaire interactif ne conviennent pas à la conformité d’archivage. La fonction exige PDF 1.2 ou ultérieur