AddLinkToSubmitForm
Anmerkungen und Hotspot-Links, Formularfelder und AcroForms
Beschreibung
Fügt der ausgewählten Seite ein anklickbares Hotspot-Rechteck hinzu, das beim Aktivieren eine PDF-Formular-Senden-Aktion auslöst; eine Formular-Senden-Aktion überträgt AcroForm-Feldwerte an eine URL oder einen Formularverarbeitungsendpunkt, ohne dass JavaScript erforderlich ist
Verwenden Sie FieldNames, um die gesendeten Felder einzuschränken. Lassen Sie FieldNames leer, damit der Viewer alle zutreffenden Felder sendet
Verwenden Sie die Funktion SetAnnotBorderColor, um die Farbe des Hotspot-Rahmens zu ändern
Syntax
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);Parameter
| Left | Die horizontale Koordinate des linken Randes des Hotspot-Rechtecks |
|---|---|
| Top | Die vertikale Koordinate des oberen Randes des Hotspot-Rechtecks |
| Width | Die Breite des Hotspot-Rechtecks |
| Height | Die Höhe des Hotspot-Rechtecks |
| URL | Die Sende-Ziel-URL, die in der Aktionsdateispezifikation gespeichert wird |
| FieldNames | Optionale Liste vollständig qualifizierter AcroForm-Feldnamen, getrennt durch Kommas, Semikolons oder Zeilenumbrüche; führende und abschließende Leerzeichen um jeden Namen werden entfernt |
| Flags | PDF-Formular-Senden-Aktions-Flags, die in den Aktionseintrag /Flags geschrieben werden; übergeben Sie 0 für die standardmäßige FDF-Übermittlung; übliche Standard-Bits: 4 für HTML-Format, 32 für XFDF und 256 zum Senden des vollständigen PDF-Dokuments |
| Options | Bitmaske zur Steuerung der Link-Darstellung. Bit 0 (Wert 1): Rahmen um das Hotspot-Rechteck zeichnen. Bits 1–3 wählen den Klick-Hervorhebungsmodus (2 = Invertieren, 4 = Umriss, 8 = Drücken); wenn kein Hervorhebungs-Bit gesetzt ist, wird Invertieren als Standard verwendet |
Rückgabewerte
| 0 | Die Aktion wurde nicht hinzugefügt, weil das Dokument im PDF/A-Modus ist, das Rechteck ungültig ist oder URL leer ist |
|---|---|
| 1 | Die Link-Anmerkung und die Formular-Senden-Aktion wurden hinzugefügt |
Hinweise
Der PDF/A-Modus blockiert diese Aktion, da sie auf ein externes Sende-Ziel verweisen kann. Die Funktion erfordert PDF 1.2 oder höher