AddLinkToHideField
Adnotacje i odnośniki aktywnych obszarów, pola formularza i AcroForms
Opis
Dodaje klikalny prostokąt hotspotu na wybranej stronie, który po aktywacji wyzwala akcję ukrycia PDF. Akcja ukrycia przełącza widoczność jednego lub kilku pól AcroForm, umożliwiając dynamiczne pokazywanie/ukrywanie bez JavaScriptu. Akcja jest zdefiniowana w ISO 32000-1 §12.6.4.10, Table 196.
Typowe użycie: link “Pokaż szczegóły” / “Ukryj szczegóły” w układzie formularza albo wzajemnie wykluczające się grupy pól, gdzie kliknięcie jednego linku ukrywa jedną grupę i pokazuje drugą (połącz dwa wywołania AddLinkToHideField z przeciwnymi wartościami HideFlag).
Kolor obramowania hotspotu zmień funkcją SetAnnotBorderColor.
Składnia
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);Parametry
| Left | Współrzędna pozioma lewej krawędzi prostokąta aktywnego obszaru |
|---|---|
| Top | Współrzędna pionowa górnej krawędzi prostokąta aktywnego obszaru |
| Width | Szerokość prostokąta aktywnego obszaru |
| Height | Wysokość prostokąta aktywnego obszaru |
| FieldNames | Jedna lub więcej w pełni kwalifikowanych nazw pól AcroForm, rozdzielonych przecinkami, średnikami lub znakami nowego wiersza. Białe znaki na początku i na końcu każdej nazwy są przycinane. Pojedyncza nazwa zapisuje /T jako łańcuch tekstowy; dwie lub więcej zapisuje /T jako tablicę łańcuchów tekstowych. |
| HideFlag | Wybiera kierunek widoczności. Wartość niezerowa ukrywa wymienione pola (/H true). Zero pokazuje je (/H false). |
| Options | Maska bitowa sterująca wyglądem odnośnika. Bit 0 (wartość 1): rysuj obramowanie wokół prostokąta aktywnego obszaru. Bity 1–3 wybierają tryb wyróżnienia po kliknięciu (2 = Invert, 4 = Outline, 8 = Push); gdy żaden bit wyróżnienia nie jest ustawiony, domyślnie używane jest Invert. Ta sama konwencja co w AddLinkToWeb / AddLinkToNamedAction. |
Uwagi
Tryby PDF/A i PDF/X-6 odrzucają akcje Hide i zwracają 0; wymagany jest PDF 1.2 lub nowszy