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