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 или по-нова версия