AddLinkToSubmitFormA
Anmerkungen und Hotspot-Links, Formularfelder und AcroForms
Beschreibung
Das angehängte A bezeichnet den ANSI-Einstiegspunkt (char) der DLL; die ActiveX/COM-Oberfläche stellt nur die Unicode-Variante bereit. Das Verhalten ist identisch mit AddLinkToSubmitForm, und Zeichenkettenargumente werden anhand der aktuellen SetAnsiMode-Codepage interpretiert
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 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);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