AddLinkToResetFormA
Аннотации и интерактивные ссылки, Поля форм и AcroForms
Описание
Завершающая A обозначает точку входа DLL типа ANSI (char); интерфейс ActiveX/COM предоставляет только форму Unicode. Поведение идентично AddLinkToResetForm, а строковые аргументы интерпретируются с использованием текущей кодовой страницы SetAnsiMode
Добавляет кликабельный прямоугольник-зону на выбранную страницу, который при активации запускает действие сброса формы PDF. Действие сброса формы восстанавливает поля AcroForm до значений по умолчанию без использования JavaScript
Используйте FieldNames, чтобы ограничить список полей, затрагиваемых действием сброса. Оставьте FieldNames пустым, чтобы просмотрщик сбросил все применимые поля
Используйте функцию SetAnnotBorderColor, чтобы изменить цвет границы интерактивной зоны
Синтаксис
Delphi
Function DLAddLinkToResetFormA(InstanceID: Integer; Left, Top, Width, Height: Double; FieldNames: PAnsiChar; Flags, Options: Integer): Integer;
DLL
int DLAddLinkToResetFormA(int InstanceID, double Left, double Top, double Width, double Height, const char * FieldNames, int Flags, int Options);
Параметры
| Left | Горизонтальная координата левого края интерактивного прямоугольника |
|---|---|
| Top | Вертикальная координата верхнего края интерактивного прямоугольника |
| Width | Ширина интерактивного прямоугольника |
| Height | Высота интерактивного прямоугольника |
| FieldNames | Необязательный список полностью квалифицированных имён полей AcroForm, разделённых запятыми, точками с запятой или переносами строк. Начальные и конечные пробелы вокруг каждого имени удаляются |
| Flags | Флаги действия сброса формы PDF, записываемые в запись действия /Flags. Передайте 0 для поведения по умолчанию. Стандартные программы просмотра используют биты флага совместно с /Fields, чтобы определить, является ли список включающим или исключающим |
| Options | Битовая маска, управляющая внешним видом ссылки. Бит 0 (значение 1): отображать границу вокруг интерактивного прямоугольника. Биты 1–3 выбирают режим выделения при нажатии (2 = Invert, 4 = Outline, 8 = Push); если ни один бит выделения не установлен, по умолчанию используется Invert |
Возвращаемые значения
| 0 | Действие не было добавлено, так как документ находится в режиме PDF/A или прямоугольник недействителен |
|---|---|
| 1 | Аннотация-ссылка и действие сброса формы успешно добавлены |
Примечания
Режим PDF/A блокирует это действие, поскольку интерактивные действия с формами не подходят для архивного соответствия. Функция требует PDF версии 1.2 или выше