AddLinkToResetForm
Аннотации и интерактивные ссылки, Поля форм и AcroForms
Описание
Добавляет кликабельный прямоугольник-зону на выбранную страницу, который при активации запускает действие сброса формы PDF. Действие сброса формы восстанавливает поля AcroForm до значений по умолчанию без использования JavaScript
Используйте FieldNames, чтобы ограничить список полей, затрагиваемых действием сброса. Оставьте FieldNames пустым, чтобы просмотрщик сбросил все применимые поля
Используйте функцию SetAnnotBorderColor, чтобы изменить цвет границы интерактивной зоны
Синтаксис
Delphi
Function TPDFlib.AddLinkToResetForm(Left, Top, Width, Height: Double; Const FieldNames: WideString; Flags, Options: Integer): Integer;DLL
int DLAddLinkToResetForm(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * 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 или выше