AddLinkToHideFieldA

Аннотации и интерактивные ссылки, Поля форм и AcroForms

Описание

Завершающая A обозначает точку входа ANSI (char) в DLL; интерфейс ActiveX/COM открывает только Unicode-форму. Поведение идентично AddLinkToHideField, а строковые аргументы интерпретируются в кодовой странице, заданной текущим режимом SetAnsiMode

Добавляет на выбранную страницу кликабельный прямоугольник активной области, запускающий PDF-действие скрытия. Действие скрытия переключает видимость одного или нескольких полей AcroForm, давая динамическое показ/скрытие без JavaScript. Действие определено в ISO 32000-1 §12.6.4.10, Table 196

Типичное применение: ссылка "Показать детали" / "Скрыть детали" в макете формы или взаимоисключающие группы полей, где щелчок по одной ссылке скрывает одну группу и показывает другую (скомбинируйте два вызова AddLinkToHideField с противоположными значениями HideFlag)

Цвет границы активной области изменяется функцией SetAnnotBorderColor

Синтаксис

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);

Параметры

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 1.2 или новее