HPDFXFAResolveFormInstanceNode

Unit: HPDFXFA

Declaration

function HPDFXFAResolveFormInstanceNode(Document: TXFADocument;
  TemplateNode, DataNode: TXFANode; CreateNode: Boolean= False;
  MaxNodes: Integer= 65536): TXFANode;

Behaviour

Resolves a template occurrence and its data context to the corresponding node within the standard XFA form packet

TemplateNode names the template element and DataNode supplies the repeated occurrence context; named template ancestors and dataset occurrence positions determine the form path

CreateNode False performs a read-only lookup and returns nil when no matching form node exists; True creates the required form packet and named ancestor nodes

The returned node belongs to Document and remains valid until that document or node is removed; the caller must not free it

Creation bounds occurrence indices with MaxNodes and path depth with a limit of 64; excessive indices or depth raise EHPDFXFAError

Related APIs

Interactive Dynamic XFA Widget Runtime, FormCalc Functions and XFA Packet DOM