ExecuteFormFieldScript

表單、JavaScript 安全性

描述

透過有界限的事件執行階段,以僅含值的相容包裝執行所選的欄位動作 支援的子集包括格式化、範圍驗證與簡單計算 API 所發出的表單輔助動作,以及對

event.value 與 event.rc 的指派,可使用算術、比較、布林運算子、條件式、受控的 Event、Field 與 Document 屬性、數值轉換與常見的 Math 函式

語法

Function TPDFlib.ExecuteFormFieldScript(Index: Integer; Action: TPDFlibFormScriptAction; Const InputValue: WideString; Out OutputValue: WideString): Integer;

參數

Index從 1 起算的表單欄位索引
Action要執行的驗證、計算、格式化或按鍵動作
InputValue以 event.value 公開的初始值
OutputValue成功執行後的最終值

傳回值

動作執行並接受該值時傳回 1;動作不存在、拒絕事件、不受支援、無效或超過設定的資源限制時傳回 0 被拒的驗證會讓

LastErrorCode 保持為零;不受支援、無效與超出預算的指令碼則回報代碼 706、708 與 709

備註

成功的計算動作會把結果寫入欄位;驗證與格式化則在不改變已儲存欄位值的情況下傳回結果

app.alert 等不受支援的陳述式、動態程式碼、全域存取與外部 I/O 一律不會被執行 需要按鍵變更、選取狀態、按鍵修飾、認可狀態或來源與目標欄位屬性時,請使用

ExecuteFormFieldScriptEvent

另請參閱

ExecuteFormFieldScriptEvent, SetFormScriptLimits, GetFormScriptDiagnostics, RecalculateFormFields, GetFormCalculationGraphJSON, TPDFlibFormScriptAction