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