AddLinkToHideFieldA
Annotations et liens réactifs, champs de formulaire et AcroForms
Description
Le A final indique le point d’entrée de DLL ANSI (char); l’interface ActiveX/COM n’expose que la forme Unicode. Le comportement est identique à AddLinkToHideField et les arguments de chaîne sont interprétés selon la page de codes SetAnsiMode actuelle
Ajoute à la page sélectionnée une zone rectangulaire cliquable qui déclenche une action PDF de masquage. Cette action change la visibilité d’un ou plusieurs champs AcroForm, permettant un comportement dynamique sans JavaScript. Elle est définie dans ISO 32000-1 §12.6.4.10, tableau 196
Usage courant : un lien “Afficher les détails” / “Masquer les détails” dans la disposition d’un formulaire, ou des groupes de champs mutuellement exclusifs où un clic masque un groupe et en affiche un autre (combinez deux appels AddLinkToHideField avec des valeurs HideFlag opposées)
Utilisez la fonction SetAnnotBorderColor pour modifier la couleur de la bordure de la zone active
Syntaxe
Delphi
Function DLAddLinkToHideFieldA(InstanceID: Integer; Left, Top, Width, Height: Double; FieldNames: PAnsiChar; HideFlag, Options: Integer): Integer;DLL
int DLAddLinkToHideFieldA(int InstanceID, double Left, double Top, double Width, double Height, const char * FieldNames, int HideFlag, 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 | Un ou plusieurs noms complets de champs AcroForm, séparés par des virgules, points-virgules ou sauts de ligne. Les espaces de début et de fin sont supprimés. Un seul nom émet /T comme chaîne de texte ; deux noms ou plus émettent /T comme tableau de chaînes |
| HideFlag | Sélectionne le sens de visibilité Une valeur non nulle masque les champs indiqués (/H true) Zéro les affiche (/H false) |
| Options | Masque de bits contrôlant l’apparence du lien. Bit 0 (valeur 1) : tracer une bordure autour de la zone. Les bits 1–3 sélectionnent la surbrillance au clic (2 = Invert, 4 = Outline, 8 = Push) ; sans bit, Invert est utilisé. Même convention que AddLinkToWeb / AddLinkToNamedAction |
Remarques
L'annotation est compatible PDF/A, car elle ne référence aucune ressource externe Nécessite PDF 1.2 ou ultérieur