显式 XFA Host Transport

单元:HPDFXFARuntime

声明

Options := TXFAWidgetRuntimeOptions.Default;
Options.ScriptOptions.EnableJavaScript := True;
Options.HostTransport := ApplicationHost.Transport;
Options.OnHostTransactionCompleted := ApplicationHost.Completed;

行为

配置显式应用 Callback 执行 xfa.host.messageBox、response、beep、print、gotoURL、submitForm、importData、exportData 与 FormCalc Get、Post、Put

库不会自动调起对话框、阅读器、网络请求或文件传输;Callback 实现应用 transport 并返回类型化响应

每个分发的请求在所在运行时事务内只运行一次;QuickJS 挂起重试与已提交会话重放消费已记录响应,不重复 Callback

请求按位置保留参数为 Unicode 字符串,包括空参数;请求序号在每个事务内从 0 开始

失败事务还原文档与脚本对象状态,并以 Committed=False 通知完成 Callback;应用必须自行暂存或补偿外部效果,因为文档回滚无法撤销外部操作

完成 Callback 在文档校验与布局成功之后或回滚之后运行一次,先于常规成功观察者;Callback 不得抛异常或重入运行时

宿主 Callback 需要随库 QuickJS 会话;自定义 JavaScriptEvaluator Callback 不提供检查点与重放契约

请求数、参数数、编码请求字节与响应字节各有独立正上限;Callback 耗时计入事务截止时间,但同步应用代码无法被强制中断

脚本函数按响应 Kind 收到 number、Boolean、string、null 或 undefined;数值响应必须有限,Unicode 响应必须含合法代理对

相关 API

显式 XFA Host Transport, TXFAHostTransaction和 交互式动态 XFA 控件运行时