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

ParameterBetekenis
ADocumentHet native document dat eigenaar is van de dataset- en template-packets
AFieldNodeHet template-veld met diens bind-declaratie of impliciete naam
ADataNodeDe huidige native data-occurrence voor impliciete en compatibility-relatieve bindingen
ACreateStaat deterministische ontbrekende paths toe om owned native elementen met geldige XML-namen aan te maken
ABindingHandledRapporteert een expliciete none- of dataRef-binding die de resolver heeft afgehandeld; een afgehandelde binding kan nog steeds nil teruggeven
RemainingOperationsGedeelde operation-ruimte, afgetrokken voor parsen, namespace-checks en traversal; nul is uitgeput en negatief schakelt deze caller-ruimte uit
DeadlineAbsolute deadline in het klok-domein van de meegeleverde callback, of negatief om elapsed-time-checks uit te schakelen
DeadlineCheckOptionele synchrone object-methode; nil checkt GetTickCount64-milliseconden

Behavior

De teruggegeven node hoort bij ADocument en mag niet door de aanroeper worden vrijgegeven; impliciete veldnamen zijn letterlijke XML-namen, punten inbegrepen

DataRef-opzoek ondersteunt $data- en $record-wortels, descendant-operators, wildcard- en class-selectors, expliciete sibling-indices, [*] en geëscapete selector-tekens; zie Native XFA Bind SOM voor voorbeelden en grenzen

Een ontbrekende impliciete waarde in een meegeleverde herhaalde occurrence blijft lokaal bij die occurrence; hij valt niet terug op een andere occurrence

Een compatibility-relatief dataRef-pad blijft ook lokaal wanneer ADataNode wordt geleverd; record- en root-fallback voor relatieve referenties geldt alleen wanneer de aanroeper geen occurrence-context heeft

Read-only opzoek alloceert geen data-nodes; creation geldt voor deterministische benoemde paths, terwijl ambigue wildcard-, class- en descendant-zoekacties opzoekoperaties blijven

Een onopgelost suffix of een exception verwijdert intermediaire nodes die deze resolver-aanroep heeft gealloceerd; eerder bestaande nodes blijven owned en ongewijzigd

Traversal gebruikt vaste limieten van 64 selector-segmenten, 64 element-niveaus en 200000 charged steps per path-traversal, naast de optionele caller-limieten

Uitgeputte operation- of elapsed-time-budgetten raisen EHPDFXFAError; interactieve edits en events herstellen hun omvattende native transactie-snapshot

Related APIs