AddLinkToSubmitForm
Annotationer og hotspot-links, Formularfelter og AcroForms
Beskrivelse
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 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);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-indsendelsesformular-handlingsflags skrevet til handlingens /Flags-post; angiv 0 for standard FDF-indsendelse; almindelige standardbits inkluderer 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