TXFADataStructureSnapshot Type
TXFADataStructureSnapshot = TArray<TXFADataStructureNodeState> em HPDFXFADataStructure é o snapshot de valores da floresta destacada usado por CaptureDetached e RestoreDetached
| Campo do estado de nó | Significado |
|---|---|
ParentIndex: Integer | -1 para uma raiz destacada, caso contrário o índice de um registo de pai anterior |
Identity: UInt64 | Identidade nativa original para remapeamento de quem chama, preservada como metadados do snapshot |
Name, Prefix, NamespaceURI, Value, InstructionTarget: AnsiString | Estado exato de elementos/conteúdo em UTF-8 |
IsCDATA: Boolean | Tratamento CDATA para texto comum |
ContentKind: TXFAXMLContentKind | Tipo de conteúdo: texto comum, comentário ou processing instruction |
Attributes, NamespaceDeclarations: TArray<AnsiString> | Entradas UTF-8 ordenadas de name=value, incluindo um reset explícito de namespace default vazio |
Os registos seguem a ordem de pai antes de filho; referências de pais inválidas, tamanho agregado, contagem de nós ou profundidade inválidos são rejeitados antes de substituir a floresta destacada existente
A restauração devolve objetos e identidades nativas frescos, pela mesma ordem do snapshot; quem retém aliases externos tem de os remapear usando esse array devolvido e as identidades guardadas
O runtime de widgets XFA faz esse remapeamento para os aliases de script persistentes dele, como parte do rollback completo de eventos