PDFium Delphi Component Docs

GetWidgetAdditionalActionJavaScript Methode

Komponente: TPdf  ·  Unit: PDFium
Liest das JavaScript einer Zusatzaktion, die an ein Formularfeld-Widget angehängt ist.

Syntax

function GetWidgetAdditionalActionJavaScript(AnnotIndex: Integer; EventType: Integer): WString;

AnnotIndexInteger. Nullbasierter Index der Widget-Anmerkung auf der aktuellen Seite.
EventTypeInteger. Welche Zusatzaktion gelesen werden soll, einer der FPDF_ANNOT_AACTION_*-Werte: FPDF_ANNOT_AACTION_KEY_STROKE (12), FPDF_ANNOT_AACTION_FORMAT (13), FPDF_ANNOT_AACTION_VALIDATE (14), FPDF_ANNOT_AACTION_CALCULATE (15).
ResultWString. Der Skriptquelltext oder ein leerer String, wenn das Widget keine solche Aktion hat.

Description

Formularfelder können ereignisbezogene Skripte tragen (ISO 32000-1 12.6.3): einen Tastendruck-Filter, eine Formatierungsroutine, die die Anzeige des Feldes umschreibt, eine Validierungsroutine und eine Berechnung, die ein Feld aus anderen ableitet. Diese Methode liest den Quelltext eines davon

Es ist eine schreibgeschützte Sicht, gedacht für Prüfung und Migration – das Skript wird als Text zurückgegeben, nicht ausgeführt. Skripte auf Dokumentebene werden stattdessen von JavaScriptActions aufgelistet

Ein leeres Ergebnis deckt auch den Fall ab, dass die Formularebene nicht aktiv ist oder dem PDFium-Build der Einstiegspunkt fehlt; ein Aufrufer, der die Unterscheidung benötigt, sollte zuerst FormHandle prüfen

See Also

JavaScriptActions, JavaScriptAction, FormFieldInfo, FormHandle