AddLinkToSubmitForm
Annotations and hotspot links, Form fields and AcroForms
Beskrivelse
Legger til et klikkbart aktivt rektangel (hotspot) på den valgte siden som utløser en PDF-innsendingshandling (submit-form) når det aktiveres. En innsendingshandling sender AcroForm-feltverdier til en URL eller et skjemabehandlingsendepunkt uten å kreve JavaScript
Bruk FieldNames for å begrense de innsendte feltene. La FieldNames være tom for å la visningsprogrammet sende inn alle aktuelle felter
Bruk funksjonen SetAnnotBorderColor for å endre fargen på grensen til det aktive rektanglet
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);
Parametere
| Left | Den horisontale koordinaten for venstre kant av det aktive rektanglet |
|---|---|
| Top | Den vertikale koordinaten for øvre kant av det aktive rektanglet |
| Width | Bredden på det aktive rektanglet |
| Height | Høyden på det aktive rektanglet |
| URL | Innsendingsmål-URL-en lagret i handlingens filspesifikasjon |
| FieldNames | Valgfri liste med fullt kvalifiserte AcroForm-feltnavn atskilt med komma, semikolon eller linjeskift. Innledende og avsluttende mellomrom rundt hvert navn trimmes |
| Flags | PDF-innsendingsflagg som skrives til handlingens /Flags-oppføring. Send 0 for standard FDF-stilinnsending. Vanlige standardbiter inkluderer 4 for HTML-format, 32 for XFDF og 256 for innsending av hele PDF-dokumentet |
| Options | Bitmaske som kontrollerer lenkens utseende. Bit 0 (verdi 1): tegn en ramme rundt det aktive rektanglet. Bit 1-3 velger uthevingsmodus ved klikk (2 = Invert, 4 = Outline, 8 = Push); når ingen uthevingsbit er satt, brukes Invert som standard |
Returverdier
| 0 | Handlingen ble ikke lagt til fordi dokumentet er i PDF/A-modus, rektanglet er ugyldig, eller URL er tom |
|---|---|
| 1 | Lenkeannotasjonen og innsendingshandlingen ble lagt til |
Merknader
PDF/A-modus blokkerer denne handlingen fordi den kan referere til et eksternt innsendingsmål. Funksjonen krever PDF 1.2 eller nyere