AddLinkToSubmitFormA
Annotationer og hotspot-links, Formularfelter og AcroForms
Beskrivelse
Det afsluttende A angiver ANSI-indgangspunktet (char) i DLL'en; ActiveX/COM-overfladen eksponerer kun Unicode-formen. Adfærden er identisk med AddLinkToSubmitForm, og strengargumenter fortolkes ud fra den aktuelle kodetabel i SetAnsiMode
Tilføjer et klikbart hotspot-rektangel til den valgte side, som udløser en PDF-indsendelsesformularhandling, når det aktiveres. En indsendelsesformularhandling sender AcroForm-feltværdier til en URL eller et formularprocesseringendepunkt uden at kræve JavaScript
Brug FieldNames til at begrænse de indsendte felter. Lad FieldNames være tom for at lade fremviseren indsende alle anvendelige felter
Brug funktionen SetAnnotBorderColor til at ændre farven på hotspot-rammen
Syntaks
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);
Parametre
| Left | Den vandrette koordinat for hotspot-rektanglets venstre kant |
|---|---|
| Top | Den lodrette koordinat for hotspot-rektanglets øverste kant |
| Width | Bredden af hotspot-rektanglet |
| Height | Højden af hotspot-rektanglet |
| URL | Mål-URL'en til indsendelsen, gemt i handlingens filspecifikation |
| FieldNames | Valgfri liste over fuldt kvalificerede AcroForm-feltnavne adskilt af kommaer, semikoloner eller linjeskift. Foranstillede og efterfølgende mellemrum omkring hvert navn fjernes |
| Flags | PDF-flag for submit-form-handlinger, der skrives til handlingens /Flags-post. Angiv 0 for standardindsendelse i FDF-stil. Almindelige standardbit omfatter 4 for HTML-format, 32 for XFDF og 256 for indsendelse af hele PDF-dokumentet |
| Options | Bitmaske der styrer linkudseendet. Bit 0 (værdi 1): tegn en ramme omkring hotspot-rektanglet. Bits 1-3 vælger klik-fremhævningstilstand (2 = Invert, 4 = Outline, 8 = Push); når intet fremhævningsbit er sat, bruges Invert som standard |
Returværdier
| 0 | Handlingen blev ikke tilføjet, fordi dokumentet er i PDF/A-tilstand, rektanglet er ugyldigt, eller URL er tom |
|---|---|
| 1 | Linkannotationen og indsendelsesformularhandlingen blev tilføjet |
Bemærkninger
PDF/A-tilstand blokerer denne handling, fordi den kan referere til et eksternt indsendelsesmål. Funktionen kræver PDF 1.2 eller nyere