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