AddLinkToHideField
Аннотации и активные ссылки, поля форм и AcroForms
Описание
Добавляет на выбранную страницу кликабельный прямоугольник активной зоны, запускающий при активации действие hide из PDF. Действие hide переключает видимость одного или нескольких полей AcroForm, позволяя динамически показывать и скрывать их без JavaScript. Действие определено в ISO 32000-1 §12.6.4.10, Table 196
Типичное применение: ссылка “Показать подробности” / “Скрыть подробности” в макете формы или взаимоисключающие группы полей, где щелчок по одной ссылке скрывает одну группу и показывает другую (объедините два вызова AddLinkToHideField с противоположными значениями HideFlag)
Используйте функцию SetAnnotBorderColor, чтобы изменить цвет границы активной зоны
Синтаксис
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);Параметры
| Left | Горизонтальная координата левого края прямоугольника активной области |
|---|---|
| Top | Вертикальная координата верхнего края прямоугольника активной области |
| Width | Ширина прямоугольника активной области |
| Height | Высота прямоугольника активной области |
| FieldNames | Одно или несколько полных имен полей AcroForm, разделенных запятыми, точками с запятой или переводами строк. Пробельные символы в начале и конце каждого имени обрезаются. Одиночное имя записывается как /T в виде текстовой строки; два и более — как /T в виде массива текстовых строк |
| HideFlag | Задает направление видимости. Ненулевое значение скрывает перечисленные поля (/H true), нулевое — показывает их (/H false) |
| Options | Битовая маска, управляющая видом ссылки. Бит 0 (значение 1): рисовать рамку вокруг прямоугольника активной области. Биты 1–3 выбирают режим подсветки щелчка (2 = Invert, 4 = Outline, 8 = Push); если ни один бит подсветки не установлен, по умолчанию используется Invert. То же соглашение, что в AddLinkToWeb / AddLinkToNamedAction |
Примечания
Режимы PDF/A и PDF/X-6 отклоняют действия Hide и возвращают 0; требуется PDF 1.2 или новее