AddLinkToHideFieldA
Adnotacje i łącza obszarów aktywnych, Pola formularzy i AcroForms
Opis
Końcowa litera A oznacza punkt wejścia DLL ANSI (char); powierzchnia ActiveX/COM udostępnia wyłącznie postać Unicode. Zachowanie jest identyczne jak w AddLinkToHideField, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode
Dodaje do wybranej strony klikalny prostokątny obszar aktywny, który po aktywacji wyzwala akcję ukrywania PDF. Akcja ukrywania przełącza widoczność jednego lub wielu pól AcroForm, umożliwiając dynamiczne pokazywanie i ukrywanie bez JavaScript. Akcję zdefiniowano w ISO 32000-1 §12.6.4.10, tabela 196.
Typowe zastosowanie: łącze “Pokaż szczegóły” / “Ukryj szczegóły” w układzie formularza albo wzajemnie wykluczające się grupy pól, gdzie kliknięcie jednego łącza ukrywa jedną grupę i pokazuje drugą (połącz dwa wywołania AddLinkToHideField z przeciwnymi wartościami HideFlag).
Aby zmienić kolor obramowania obszaru aktywnego, użyj funkcji SetAnnotBorderColor
Składnia
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);Parametry
| Left | Pozioma współrzędna lewej krawędzi prostokąta obszaru aktywnego |
|---|---|
| Top | Pionowa współrzędna górnej krawędzi prostokąta obszaru aktywnego |
| Width | Szerokość prostokąta obszaru aktywnego |
| Height | Wysokość prostokąta obszaru aktywnego |
| FieldNames | Co najmniej jedna w pełni kwalifikowana nazwa pola AcroForm, rozdzielona przecinkami, średnikami lub podziałami wiersza. Początkowe i końcowe białe znaki wokół każdej nazwy są usuwane. Pojedyncza nazwa emituje /T jako ciąg tekstowy; co najmniej dwie emitują /T jako tablicę ciągów tekstowych. |
| HideFlag | Wybiera kierunek zmiany widoczności. Wartość różna od zera ukrywa wymienione pola (/H true). Zero je pokazuje (/H false). |
| Options | Maska bitowa sterująca wyglądem łącza. Bit 0 (wartość 1): narysuj obramowanie wokół prostokąta obszaru aktywnego. Bity 1–3 wybierają tryb wyróżnienia kliknięcia (2 = Invert, 4 = Outline, 8 = Push); gdy nie ustawiono żadnego bitu wyróżnienia, domyślnie używany jest Invert. Ta sama konwencja co w AddLinkToWeb / AddLinkToNamedAction. |
Uwagi
Adnotacja jest zgodna z PDF/A, ponieważ nie odwołuje się do zasobu zewnętrznego. Wymagany jest PDF 1.2 lub nowszy.