AddLinkToSubmitForm
Аннотации и интерактивные ссылки, Поля форм и AcroForms
Описание
Добавляет кликабельный прямоугольник-зону на выбранную страницу, который при активации запускает действие отправки формы PDF. Действие отправки формы пересылает значения полей AcroForm на URL или конечную точку обработки формы без использования JavaScript
Используйте FieldNames, чтобы ограничить набор отправляемых полей. Оставьте FieldNames пустым, чтобы просмотрщик отправил все применимые поля
Используйте функцию SetAnnotBorderColor, чтобы изменить цвет границы интерактивной зоны
Синтаксис
Delphi
Function TPDFlib.AddLinkToSubmitForm(Left, Top, Width, Height: Double; Const URL, FieldNames: WideString; Flags, Options: Integer): Integer;DLL
int DLAddLinkToSubmitForm(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * URL, const wchar_t * FieldNames, int Flags, int Options);Параметры
| Left | Горизонтальная координата левого края интерактивного прямоугольника |
|---|---|
| Top | Вертикальная координата верхнего края интерактивного прямоугольника |
| Width | Ширина интерактивного прямоугольника |
| Height | Высота интерактивного прямоугольника |
| URL | Целевой URL для отправки, сохраняемый в спецификации файла действия |
| FieldNames | Необязательный список полностью квалифицированных имён полей AcroForm, разделённых запятыми, точками с запятой или переносами строк. Начальные и конечные пробелы вокруг каждого имени удаляются |
| Flags | Флаги действия отправки формы PDF, записываемые в запись действия /Flags. Передайте 0 для отправки в формате FDF по умолчанию. Общие стандартные биты: 4 для формата HTML, 32 для XFDF, 256 для отправки полного PDF-документа |
| Options | Битовая маска, управляющая внешним видом ссылки. Бит 0 (значение 1): отображать границу вокруг интерактивного прямоугольника. Биты 1–3 выбирают режим выделения при нажатии (2 = Invert, 4 = Outline, 8 = Push); если ни один бит выделения не установлен, по умолчанию используется Invert |
Возвращаемое значение
| 0 | Действие не было добавлено, так как документ находится в режиме PDF/A, прямоугольник недействителен или URL пуст |
|---|---|
| 1 | Аннотация-ссылка и действие отправки формы успешно добавлены |
Примечания
Режим PDF/A блокирует это действие, поскольку оно может ссылаться на внешний целевой объект для отправки. Функция требует PDF версии 1.2 или выше