AddLinkToSubmitForm

Anotace a aktivní oblasti odkazů, Pole formuláře a AcroForms

Popis

Přidá klikatelný obdélník aktivní oblasti na vybranou stránku, který při aktivaci spustí akci odeslání formuláře PDF. Akce odeslání formuláře odešle hodnoty polí AcroForm na URL nebo koncový bod zpracování formuláře bez nutnosti použití JavaScriptu

Pomocí FieldNames lze omezit odesílaná pole. Ponechejte FieldNames prázdné, aby prohlížeč odeslal všechna příslušná pole

Pomocí funkce SetAnnotBorderColor změňte barvu ohraničení aktivní oblasti

Syntaxe

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

Parametry

LeftVodorovná souřadnice levého okraje obdélníku aktivní oblasti
TopSvislá souřadnice horního okraje obdélníku aktivní oblasti
WidthŠířka obdélníku aktivní oblasti
HeightVýška obdélníku aktivní oblasti
URLCílová URL pro odeslání uložená ve specifikaci souboru akce
FieldNamesVolitelný seznam plně kvalifikovaných názvů polí AcroForm oddělených čárkami, středníky nebo odřádkováním. Počáteční a koncové bílé znaky kolem každého názvu jsou oříznuty
FlagsPříznaky akce odeslání formuláře PDF zapsané do položky /Flags akce. Pro výchozí odeslání ve stylu FDF předejte 0. Běžné standardní bity zahrnují 4 pro formát HTML, 32 pro XFDF a 256 pro odeslání celého dokumentu PDF
OptionsBitová maska řídící vzhled odkazu. Bit 0 (hodnota 1): nakreslit ohraničení kolem obdélníku aktivní oblasti. Bity 1–3 vybírají režim zvýraznění kliknutí (2 = Invertovat, 4 = Obrys, 8 = Stisknout); pokud není nastaven žádný bit zvýraznění, použije se výchozí Invertovat

Vrácená hodnota

0Akce nebyla přidána, protože dokument je v režimu PDF/A, obdélník je neplatný nebo URL je prázdné
1Anotace odkazu a akce odeslání formuláře byly přidány

Poznámky

Režim PDF/A blokuje tuto akci, protože může odkazovat na externí cíl odeslání. Funkce vyžaduje PDF 1.2 nebo novější