AddLinkToResetForm
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-Zurücksetzen-Aktion auslöst; diese Aktion stellt AcroForm-Felder auf ihre Standardwerte zurück, ohne dass JavaScript erforderlich ist
Verwenden Sie FieldNames, um die von der Zurücksetzen-Aktion betroffenen Felder einzuschränken. Lassen Sie FieldNames leer, damit der Viewer alle zutreffenden Felder zurücksetzt
Verwenden Sie die Funktion SetAnnotBorderColor, um die Farbe des Hotspot-Rahmens zu ändern
Syntax
Delphi
Function TPDFlib.AddLinkToResetForm(Left, Top, Width, Height: Double; Const FieldNames: WideString; Flags, Options: Integer): Integer;DLL
int DLAddLinkToResetForm(int InstanceID, double Left, double Top, double Width, double Height, 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 |
| 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-Zurücksetzen-Aktions-Flags, die in den Aktionseintrag /Flags geschrieben werden; übergeben Sie 0 für das Standardverhalten; Standardbetrachter verwenden die Flag-Bits zusammen mit /Fields, um zu entscheiden, ob die Liste einschließend oder ausschließend ist |
| 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 oder das Rechteck ungültig ist |
|---|---|
| 1 | Die Link-Anmerkung und die Formular-Zurücksetzen-Aktion wurden hinzugefügt |
Hinweise
Der PDF/A-Modus blockiert diese Aktion, da interaktive Formularaktionen für die Archivierungskonformität nicht geeignet sind. Die Funktion erfordert PDF 1.2 oder höher