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;它會初始化 widget、計算、reflow、版面、script 與 host transport 限制,選填 callback 為 nil

ScriptOptions.EnableJavaScript 啟用一般 QuickJS 事件與 script 物件;HostTransport 與 OnHostTransactionCompleted 提供明確的應用程式效果與交易結果協調

instance 與 widget 解析 callback 支援獨立的呈現設定檔;MonotonicMilliseconds 可提供應用程式時鐘,用於耗時預算

HostModel 從 TXFAHostModelState.Default 起步;建構前提供應用程式中繼資料、標題與計算/驗證旗標,實際頁面與焦點則由 runtime 版面與互動決定

既有的隱含資料綁定使用即時原生查找,獨立受 MaxLayoutOperations 約束,較大的掃描過程會檢查交易期限;它們不像重複的 SOM 解析那樣消耗 ScriptOptions.Limits.MaxOperations

明確的 bind selector、缺失值建立與其他 script 操作保留其交易範圍限制;查找、rollback 與期限行為請見隱含綁定預算

相關 API

明確的 XFA Host Transport、TXFAHostTransaction與互動式動態 XFA Widget Runtime