AddLinkToHideField
Adnotări și legături hotspot, câmpuri de formular și AcroForms
Descriere
Adaugă un dreptunghi hotspot clicabil pe pagina selectată, care declanșează o acțiune PDF hide la activare. O acțiune hide comută vizibilitatea unuia sau mai multor câmpuri AcroForm, permițând un comportament dinamic de afișare/ascundere fără JavaScript. Acțiunea este definită în ISO 32000-1 §12.6.4.10, Table 196Utilizare tipică: o legătură “Arată detaliile” / “Ascunde detaliile” într-un aranjament de formular sau grupuri de câmpuri reciproc exclusive, în care un clic pe o legătură ascunde un grup și afișează altul (combinați două apeluri AddLinkToHideField cu valori HideFlag opuse)Folosiți funcția SetAnnotBorderColor pentru a schimba culoarea chenarului zonei hotspot
Utilizare tipică: un link “Show details” / “Hide details” într-un layout de formular, sau grupuri de câmpuri reciproc exclusive în care click pe un link ascunde un grup și afișează altul (combinați două apeluri AddLinkToHideField cu valori HideFlag opuse)
Folosiți funcția SetAnnotBorderColor pentru a schimba culoarea chenarului hotspot.
Sintaxă
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);Parametri
| Left | Coordonata orizontală a marginii stângi a dreptunghiului hotspot |
|---|---|
| Top | Coordonata verticală a marginii superioare a dreptunghiului hotspot |
| Width | Lățimea dreptunghiului hotspot |
| Height | Înălțimea dreptunghiului hotspot |
| FieldNames | Unul sau mai multe nume de câmpuri AcroForm complet calificate, separate prin virgule, punct și virgulă sau întreruperi de rând. Spațiile albe de la începutul și de la sfârșitul fiecărui nume sunt eliminate. Un nume unic emite /T ca șir de text; două sau mai multe emit /T ca matrice de șiruri de text. |
| HideFlag | Selectează direcția vizibilității. O valoare nenulă ascunde câmpurile listate (/H true). Zero le afișează (/H false). |
| Options | Mască de biți care controlează aspectul legăturii. Bitul 0 (valoarea 1): desenează un chenar în jurul dreptunghiului hotspot. Biții 1–3 selectează modul de evidențiere la clic (2 = Invert, 4 = Outline, 8 = Push); când niciun bit de evidențiere nu este activat, Invert este folosit ca implicit. Aceeași convenție ca AddLinkToWeb / AddLinkToNamedAction. |
Observații
Modurile PDF/A și PDF/X-6 resping acțiunile Hide și returnează 0; este necesar PDF 1.2 sau ulterior