AddLinkToSubmitForm

Anotacijos ir aktyviosios srities nuorodos, Formos laukai ir AcroForms

Aprašas

Prideda spustelėjamą aktyviosios srities (hotspot) stačiakampį pasirinktame puslapyje, kuris suaktyvintas paleidžia PDF formos pateikimo (submit-form) veiksmą. Formos pateikimo veiksmas siunčia AcroForm laukų reikšmes į URL arba formos apdorojimo galinį tašką (endpoint), nereikalaudamas JavaScript

Naudokite FieldNames, kad apribotumėte pateikiamus laukus. Palikite FieldNames tuščią, kad peržiūros programa pateiktų visus atitinkamus laukus

Naudokite funkciją SetAnnotBorderColor norėdami pakeisti aktyviosios srities rėmelio spalvą

Sintaksė

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);

Parametrai

Left	Aktyviosios srities stačiakampio kairiojo krašto horizontali koordinatė
Top	Aktyviosios srities stačiakampio viršutinio krašto vertikali koordinatė
Width	Aktyviosios srities stačiakampio plotis
Height	Aktyviosios srities stačiakampio aukštis
URL	Pateikimo tikslo URL, saugomas veiksmo failo specifikacijoje
FieldNames	Neprivalomas pilnai apibrėžtų AcroForm laukų pavadinimų sąrašas, atskirtas kableliais, kabliataškiais arba eilučių lūžiais. Priekiniai ir galiniai tarpai aplink kiekvieną pavadinimą yra apkerpami
Flags	PDF formos pateikimo veiksmo vėliavėlės, įrašytos į veiksmo `/Flags` įrašą. Perduokite 0 numatytajam FDF stiliaus pateikimui. Įprasti standartiniai bitai apima 4 HTML formatui, 32 XFDF ir 256 viso PDF dokumento pateikimui
Options	Bitų kaukė (bitmask), valdanti nuorodos išvaizdą. 0 bitas (reikšmė 1): brėžti rėmelį aplink aktyviosios srities stačiakampį. 1-3 bitai parenka paspaudimo paryškinimo režimą (2 = Invert, 4 = Outline, 8 = Push); kai nenustatytas joks paryškinimo bitas, kaip numatytasis naudojamas Invert

Grąžinama reikšmė

0	Veiksmas nebuvo pridėtas, nes dokumentas yra PDF/A režime, stačiakampis yra neteisingas arba `URL` yra tuščias
1	Nuorodos anotacija ir formos pateikimo veiksmas buvo pridėti

Pastabos

PDF/A režimas blokuoja šį veiksmą, nes jis gali nurodyti išorinį pateikimo tikslą. Funkcijai reikia PDF 1.2 arba naujesnės versijos