TXFADataStructureSnapshot Type

HPDFXFADataStructure 中的 TXFADataStructureSnapshot = TArray<TXFADataStructureNodeState> 是 CaptureDetached 與 RestoreDetached 使用的分離森林值快照

節點狀態欄位含義
ParentIndex: Integer分離根為 -1,否則指向較早的父記錄索引
Identity: UInt64供呼叫端重映射的原始原生身分,作為快照詮釋資料保留
Name、Prefix、NamespaceURI、Value、InstructionTarget: AnsiString精確的 UTF-8 元素/內容狀態
IsCDATA: Boolean一般文字是否按 CDATA 處理
ContentKind: TXFAXMLContentKind一般文字、註解或處理指令的內容種類
Attributes、NamespaceDeclarations: TArray<AnsiString>有序 UTF-8 name=value 條目,包含明確的空預設命名空間重設

記錄遵循父先於子的順序;非法父參照、彙總尺寸、節點數或深度會在替換既有分離森林之前被拒絕

還原回傳全新物件與原生身分,順序與快照一致;保留外部別名的呼叫端必須用回傳陣列與儲存的身分重新映射

XFA widget 執行期在完整事件 rollback 中為其持久腳本別名執行這一重映射