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
| Left | Den horisontella koordinaten för hotspontrektangelns vänstra kant |
|---|---|
| Top | Den vertikala koordinaten för hotspontrektangelns övre kant |
| Width | Bredden på hotspontrektangeln |
| Height | Höjden på hotspontrektangeln |
| URL | Målets URL för inskickning, lagrad i åtgärdens filspecifikation |
| FieldNames | Valfri lista med fullständigt kvalificerade AcroForm-fältnamn åtskilda med kommatecken, semikolon eller radbrytningar. Inledande och avslutande blanksteg runt varje namn trimmas |
| Flags | PDF-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 |
| Options | Bitmask 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 |
|---|---|
| 1 | Lä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