AddLinkToSubmitForm

Annotationer och hotspontlänkar, Formulärfält och AcroForms

Beskrivning

Lägger till en klickbar hotspontrektangel på den valda sidan som utlöser en PDF-formulärinskickningsåtgärd när den aktiveras. En formulärinskickningsåtgärd skickar AcroForm-fältvärden till en URL eller ett formulärbearbetningsslutpunkt utan att JavaScript krävs

Använd FieldNames för att begränsa vilka fält som skickas in. Lämna FieldNames tomt för att låta visningsprogrammet skicka in alla tillämpliga fält

Använd funktionen SetAnnotBorderColor för att ändra färgen på hotspontrektangelns kantlinje

Syntax

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

Parametrar

LeftDen horisontella koordinaten för hotspontrektangelns vänstra kant
TopDen vertikala koordinaten för hotspontrektangelns övre kant
WidthBredden på hotspontrektangeln
HeightHöjden på hotspontrektangeln
URLMålets URL för inskickning, lagrad i åtgärdens filspecifikation
FieldNamesValfri lista med fullständigt kvalificerade AcroForm-fältnamn åtskilda med kommatecken, semikolon eller radbrytningar. Inledande och avslutande blanksteg runt varje namn trimmas
FlagsPDF-formulärinskickningsåtgärdens flaggor skrivna till åtgärdens /Flags-post. Ange 0 för FDF-standardinskickning. Vanliga standardbitar inkluderar 4 för HTML-format, 32 för XFDF och 256 för inskickning av hela PDF-dokumentet
OptionsBitmask som styr länkens utseende. Bit 0 (värde 1): rita en kantlinje runt hotspontrektangeln. Bit 1–3 väljer klickmarkeringsläge (2 = Invert, 4 = Outline, 8 = Push); om ingen markeringsbit är satt används Invert som standard

Returvärden

0Åtgärden lades inte till eftersom dokumentet är i PDF/A-läge, rektangeln är ogiltig eller URL är tom
1Länkannoteringen och formulärinskickningsåtgärden lades till

Anmärkningar

PDF/A-läge blockerar denna åtgärd eftersom den kan referera till ett externt inskickningsmål. Funktionen kräver PDF 1.2 eller senare