AddLinkToSubmitForm
Annotaties en hotspot-koppelingen, Formuliervelden en AcroForms
Beschrijving
Voegt een klikbaar hotspot-rechthoek toe aan de geselecteerde pagina dat een PDF-formulierinzendingsactie activeert wanneer erop wordt geklikt. Een formulierinzendingsactie verzendt AcroForm-veldwaarden naar een URL of formulierverwerkingseindpunt zonder dat JavaScript vereist is
Gebruik FieldNames om de ingezonden velden te beperken; laat FieldNames leeg zodat de viewer alle toepasselijke velden inzendt
Gebruik de functie SetAnnotBorderColor om de kleur van de hotspot-rand te wijzigen
Syntaxis
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);Parameters
| Left | De horizontale coördinaat van de linkerrand van de hotspot-rechthoek |
|---|---|
| Top | De verticale coördinaat van de bovenrand van de hotspot-rechthoek |
| Width | De breedte van de hotspot-rechthoek |
| Height | De hoogte van de hotspot-rechthoek |
| URL | De doel-URL voor het indienen, opgeslagen in de bestandsspecificatie van de actie |
| FieldNames | Optionele lijst van volledig gekwalificeerde AcroForm-veldnamen, gescheiden door komma's, puntkomma's of regeleinden. Voorloop- en volgspaties rondom elke naam worden verwijderd |
| Flags | PDF-formulierinzendingsactie-vlaggen die worden geschreven naar de /Flags-invoer van de actie. Geef 0 door voor de standaard FDF-stijl inzending. Veelgebruikte standaardbits zijn 4 voor HTML-indeling, 32 voor XFDF en 256 voor het indienen van het volledige PDF-document |
| Options | Bitmask voor het regelen van het uiterlijk van de koppeling. Bit 0 (waarde 1): teken een rand rondom de hotspot-rechthoek. Bits 1-3 selecteren de klikhighlightmodus (2 = Inverteren, 4 = Omtrek, 8 = Indrukken); wanneer geen highlightbit is ingesteld, wordt Inverteren als standaard gebruikt |
Returnwaarde
| 0 | De actie is niet toegevoegd omdat het document in PDF/A-modus staat, de rechthoek ongeldig is of URL leeg is |
|---|---|
| 1 | De koppelingannotatie en de formulierinzendingsactie zijn toegevoegd |
Opmerkingen
PDF/A-modus blokkeert deze actie omdat deze kan verwijzen naar een extern inzendingsdoel. De functie vereist PDF 1.2 of hoger