AddLinkToResetForm

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 resetování formuláře PDF. Akce resetování formuláře obnoví pole AcroForm na jejich výchozí hodnoty bez nutnosti použití JavaScriptu

Pomocí FieldNames lze omezit pole, která jsou resetováním ovlivněna. Ponechejte FieldNames prázdné, aby prohlížeč resetoval všechna příslušná pole

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

Syntaxe

Delphi

Function TPDFlib.AddLinkToResetForm(Left, Top, Width, Height: Double; Const FieldNames: WideString; Flags, Options: Integer): Integer;

DLL

int DLAddLinkToResetForm(int InstanceID, double Left, double Top, double Width, double Height, 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
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 resetování formuláře PDF zapsané do položky /Flags akce. Pro výchozí chování předejte 0. Standardní prohlížeče používají bity příznaků spolu s /Fields k rozhodnutí, zda je seznam inkluzivní nebo exkluzivní
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 nebo obdélník je neplatný
1Anotace odkazu a akce resetování formuláře byly přidány

Poznámky

Režim PDF/A blokuje tuto akci, protože interaktivní akce formuláře nejsou vhodné pro archivační shodu. Funkce vyžaduje PDF 1.2 nebo novější