AddLinkToResetForm

Annotations et liens réactifs, champs de formulaire et AcroForms

Description

Ajoute à la page sélectionnée un rectangle réactif cliquable qui déclenche une action PDF reset-form lors de son activation. Une action reset-form rétablit les valeurs par défaut des champs AcroForm sans nécessiter de 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 changer la couleur de la bordure du rectangle réactif

Syntaxe

Delphi

Function TPDFlib.AddLinkToResetForm(Left, Top, Width, Height: Double; Const FieldNames: WideString; Flags, Options: Integer): Integer;

DLL

int DLAddLinkToResetForm(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FieldNames, int Flags, int Options);

Paramètres

Left	Coordonnée horizontale du bord gauche du rectangle réactif
Top	Coordonnée verticale du bord supérieur du rectangle réactif
Width	La largeur du rectangle réactif
Height	La hauteur du rectangle réactif
FieldNames	Liste facultative de noms de champs AcroForm pleinement qualifiés, séparés par des virgules, des points-virgules ou des sauts de ligne. Les espaces de début et de fin autour de chaque nom sont supprimés
Flags	Indicateurs de l'action PDF reset-form écrits dans l'entrée `/Flags` de l'action. Passez 0 pour le comportement par défaut. Les visionneuses standard utilisent ces bits conjointement 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) : dessine une bordure autour du rectangle réactif. Les bits 1-3 sélectionnent le mode de surbrillance au clic (2 = Invert, 4 = Outline, 8 = Push) ; lorsqu'aucun bit de surbrillance n'est défini, Invert 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 ou PDF/X-6, ou le rectangle est invalide
1	L'annotation de lien et l'action reset-form ont été ajoutées

Remarques

Les modes PDF/A et PDF/X-6 bloquent cette action ; la fonction requiert la version PDF 1.2 ou ultérieure