TXFADataStructureSnapshot Type

HPDFXFADataStructure の TXFADataStructureSnapshot = TArray<TXFADataStructureNodeState> は、CaptureDetached と RestoreDetached が使う分離フォレストの値スナップショットです

ノード状態フィールド意味
ParentIndex: Integer分離ルートでは -1、それ以外ではより前の親レコードのインデックス
Identity: UInt64呼び出し側の再マッピング用の元のネイティブ ID。スナップショットメタデータとして保持されます
Name, Prefix, NamespaceURI, Value, InstructionTarget: AnsiString正確な UTF-8 の要素・コンテンツ状態
IsCDATA: Boolean通常テキストの CDATA 扱い
ContentKind: TXFAXMLContentKind通常テキスト、コメント、処理命令のコンテンツ種類
Attributes, NamespaceDeclarations: TArray<AnsiString>順序付き UTF-8 の name=value エントリ。明示的な空デフォルト名前空間のリセットを含みます

レコードは親が子に先行する順序に従います。無効な親参照、合計サイズ、ノード数、深さは、既存の分離フォレストを置き換える前に拒否されます

復元は、スナップショットと同じ順序で、新しいオブジェクトとネイティブ ID を返します。外部エイリアスを保持する呼び出し側は、その返却配列と保存された ID を使って再マップしなければなりません

XFA ウィジェットランタイムは、完全なイベントロールバックの一部として、永続的なスクリプトエイリアスのこの再マップを行います