AddLinkToHideField
Annotations et liens réactifs, champs de formulaire et AcroForms
Description
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 TPDFlib.AddLinkToHideField(Left, Top, Width, Height: Double; Const FieldNames: WideString; HideFlag: Integer; Options: Integer): Integer;DLL
int DLAddLinkToHideField(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FieldNames, int HideFlag, 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 | Un ou plusieurs 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. Un nom unique émet /T sous forme de chaîne de texte ; deux noms ou plus émettent /T sous forme de tableau de chaînes de texte. |
| HideFlag | Sélectionne le sens de la visibilité. Une valeur non nulle masque les champs listés (/H true). Zéro les affiche (/H false). |
| 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. Même convention que AddLinkToWeb / AddLinkToNamedAction. |
Remarques
Les modes PDF/A et PDF/X-6 rejettent les actions Hide et renvoient 0 ; la version PDF 1.2 ou ultérieure est requise