TXFAWidgetRuntimeOptions

单元:HPDFXFARuntime

声明

TXFAWidgetRuntimeOptions= record
  MaxWidgets, MaxValueChars, MaxCalculationPasses, MaxReflowPasses, MaxLayoutOperations: Integer;
  ScriptOptions: TXFAFormScriptOptions;
  HostTransport: TXFAHostTransport;
  OnHostTransactionCompleted: TXFAHostTransactionCompleted;
  HostTransportLimits: TXFAHostTransportLimits;
  HostModel: TXFAHostModelState;
  MeasureText: TXFAMeasureTextFunc;
  ResolveInstanceProperty: TXFAResolveInstanceProperty;
  ResolveInstanceScope: TXFAResolveInstanceScope;
  ResolveWidgetIdentity: TXFAResolveWidgetIdentity;
  ResolutionStarted: TXFAResolutionStarted;
  ValidateDocument: TXFAUpdateDocumentAction;
  MonotonicMilliseconds: TXFAMonotonicMillisecondsFunc;
  class function Default: TXFAWidgetRuntimeOptions; static;
end;

行为

配置记录前先调用 Default;它以 nil 可选 Callback 初始化控件、计算、reflow、布局、脚本与 host transport 限制

ScriptOptions.EnableJavaScript 启用通用 QuickJS 事件与脚本对象;HostTransport 与 OnHostTransactionCompleted 提供显式应用效果与事务结果协调

实例与控件解析 Callback 支持独立的呈现 profile;MonotonicMilliseconds 可为耗时预算提供应用时钟

HostModel 从 TXFAHostModelState.Default 出发;构造前提供应用元数据、标题与计算/校验标志,实际页面与焦点由运行时布局与交互决定

既有隐式数据绑定使用实时原生查找,独立受 MaxLayoutOperations 约束,较大扫描期间有事务截止时间检查;它们不像重复 SOM 解析那样消耗 ScriptOptions.Limits.MaxOperations

显式 bind 选择器、缺失值创建与其他脚本操作保留其事务级限制;查找、回滚与截止时间行为参见 Implicit Binding Budgets

相关 API

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