HPDFXFAResolveBoundDataNode

Unit: HPDFXFA

Declarations

function HPDFXFAResolveBoundDataNode(ADocument: TXFADocument;
  AFieldNode, ADataNode: TXFANode; ACreate: Boolean;
  out ABindingHandled: Boolean): TXFANode; overload;

function HPDFXFAResolveBoundDataNode(ADocument: TXFADocument;
  AFieldNode, ADataNode: TXFANode; ACreate: Boolean;
  out ABindingHandled: Boolean; var RemainingOperations: Integer;
  Deadline: Int64; DeadlineCheck: TXFABindingDeadlineCheck = nil): TXFANode; overload;

Parameters

ParameterMeaning
ADocumentThe native document owning the dataset and template packets
AFieldNodeThe template field containing its bind declaration or implicit name
ADataNodeThe current native data occurrence for implicit and compatibility relative bindings
ACreateLets deterministic missing paths create owned native elements with valid XML names
ABindingHandledReports an explicit none or dataRef binding handled by the resolver; a handled binding may still return nil
RemainingOperationsShared operation allowance, decremented for parsing, namespace checks and traversal; zero means exhausted and a negative value disables this caller allowance
DeadlineAbsolute deadline in the supplied callback's clock domain, or a negative value to disable elapsed-time checks
DeadlineCheckOptional synchronous object method; with nil, GetTickCount64 milliseconds are checked

Behaviour

The returned node belongs to ADocument and must not be freed by the caller; implicit field names are literal XML names, dots included

DataRef lookup supports $data and $record roots, descendant operators, wildcard and class selectors, explicit sibling indices, [*] and escaped selector characters; see Native XFA Bind SOM for worked examples and boundaries

A missing implicit value in a supplied repeated occurrence remains local to that occurrence; it does not fall back to another occurrence

A compatibility relative dataRef path also remains local when ADataNode is supplied; record and root fallback for relative references applies only when the caller has no occurrence context

Read-only lookup does not allocate data nodes; creation applies to deterministic named paths, whilst ambiguous wildcard, class and descendant searches remain lookup operations

An unresolved suffix or exception discards intermediate nodes allocated by this resolver call; previously existing nodes remain owned and unchanged

Traversal uses fixed limits of 64 selector segments, 64 element levels and 200000 charged steps per path traversal, on top of the optional caller limits

Exhausted operation or elapsed-time budgets raise EHPDFXFAError; interactive edits and events restore the enclosing native transaction snapshot

Related APIs