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

LeftCoordonnée horizontale du bord gauche du rectangle de la zone active
TopCoordonnée verticale du bord supérieur du rectangle de la zone active
WidthLargeur du rectangle de la zone active
HeightHauteur du rectangle de la zone active
FieldNamesListe 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
FlagsIndicateurs 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
OptionsMasque 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

0L’action n’a pas été ajoutée : le document est en mode PDF/A ou le rectangle est invalide
1L’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