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 = Інвертувати, 4 = Контур, 8 = Натиснути); якщо жоден біт підсвічування не встановлено, за замовчуванням використовується Інвертувати |
Повернуване значення
| 0 | Дію не було додано, оскільки документ перебуває в режимі PDF/A, прямокутник є недійсним, або URL порожній |
|---|---|
| 1 | Анотацію посилання та дію відправки форми додано |
Примітки
Режим PDF/A блокує цю дію, оскільки вона може посилатися на зовнішню цільову адресу відправки. Функція вимагає PDF 1.2 або новіший