AddLinkToSubmitFormA
Annotaties en hotspot-koppelingen, Formuliervelden en AcroForms
Beschrijving
Het achtervoegsel A duidt het ANSI-toegangspunt (char) van de DLL aan; het ActiveX/COM-oppervlak stelt alleen de Unicode-vorm beschikbaar. Het gedrag is identiek aan AddLinkToSubmitForm en tekenreeksargumenten worden geïnterpreteerd met behulp van de huidige SetAnsiMode-codetabel
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 verzonden velden te beperken. Laat FieldNames leeg om de viewer alle toepasselijke velden te laten verzenden
Gebruik de functie SetAnnotBorderColor om de kleur van de hotspot-rand te wijzigen
Syntaxis
Delphi
Function DLAddLinkToSubmitFormA(InstanceID: Integer; Left, Top, Width, Height: Double; URL, FieldNames: PAnsiChar; Flags, Options: Integer): Integer;
DLL
int DLAddLinkToSubmitFormA(int InstanceID, double Left, double Top, double Width, double Height, const char * URL, const char * FieldNames, int Flags, int Options);
Syntaxis
| 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 |
Retourwaarden
| 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