ExecuteFormFieldScript
表单、JavaScript 安全
描述
通过有界事件运行时执行所选字段动作,使用仅含值的兼容包装 受支持的子集包括格式化、范围校验和简单计算 API 生成的表单辅助动作,以及使用算术运算、比较、布尔运算符、条件语句、受控的 Event/Field/Document 属性、数值转换和常用
event.value 函数对 event.rc 和 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(保持为 0);不受支持、无效和超预算的脚本分别报告错误码 706、708 和 709
备注
计算动作成功时会把结果写入字段,而校验和格式化只返回结果,不改变存储的字段值
app.alert 等不受支持的语句、动态代码、全局访问和外部 I/O 一律不会被调用
需要按键更改、选定状态、按键修饰符、提交状态或源字段与目标字段属性时,请使用
ExecuteFormFieldScriptEvent
另请参阅
ExecuteFormFieldScriptEvent, SetFormScriptLimits, GetFormScriptDiagnostics, RecalculateFormFields, GetFormCalculationGraphJSON, TPDFlibFormScriptAction