SetFormFieldActionEx
Formularfelder, Anmerkungen und Hotspot-Links
Beschreibung
Erstellt und weist eine Formularfeld-Trigger-Aktion unter Verwendung eines Ereignisnamens und einer benannten Action-Builder-Konstante zu
Syntax
Delphi
Function TPDFlib.SetFormFieldActionEx(Index: Integer; Const EventName: WideString; ActionKind: Integer; Const Value, FieldNames: WideString; Flags, DestID: Integer): Integer;Parameter
| Index | Der 1-basierte Formularfeld-Index |
|---|---|
| EventName | Der Trigger-Ereignisname, etwa MouseUp, MouseDown, MouseEnter, MouseExit, Focus, LostFocus, KeyPress, BeforeFormatting, Change oder Calculate |
| ActionKind | Eine der PDF_ACTION_BUILDER_*-Konstanten, die AddActionNextEx unterstützt |
| Value | Der URI, die benannte Aktion, der JavaScript-Quelltext, der Importdaten-Dateiname oder der für Ziel-Aktionen ungenutzte Wert |
| FieldNames | Eine durch Kommas getrennte Feldliste für Hide-, Submit- und Reset-Aktionen |
| Flags | Aktionsspezifische Flags oder der 1-basierte Thread-Index für PDF_ACTION_BUILDER_THREAD |
| DestID | Das Ziel-Handle für PDF_ACTION_BUILDER_DESTINATION oder ein 1-basierter Bead-Index für PDF_ACTION_BUILDER_THREAD, wobei 0 den ersten Bead auswählt |
Rückgabewerte
| 0 | Feld, Ereignisname, Aktionsart oder erforderlicher Wert war ungültig, oder der PDF/X-6-Modus ist aktiv |
|---|---|
| 1 | Die Aktion wurde erstellt und dem ausgewählten Feldereignis zugewiesen |
Hinweise
Dieser Helper kombiniert die Ereignisnamen-Auflösung mit der Aktionserstellung, wodurch separate temporäre Aktions-Handles entfallen, wenn ein Feldereignis nur eine direkte URI-, JavaScript-, Hide-, Submit-, Reset-, Importdaten-, Named-, Ziel- oder Artikel-Thread-Aktion benötigt Zusätzliche Formularfeld-Aktionen werden abgelehnt, solange der PDF/A- oder PDF/X-6-Modus aktiv ist, da beide Profile
/AA-Wörterbücher für Felder und Widgets verbieten, selbst wenn der gewählte Aktionstyp ansonsten zulässig wäre