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;Parametre
| Parameter | Betydning |
|---|---|
| ADocument | Det native dokument, der ejer datasets- og skabelonpakkerne |
| AFieldNode | Skabelonfeltet, der indeholder sin bind-erklæring eller implicitte navn |
| ADataNode | Den aktuelle native data-occurrence til implicitte og kompatibilitets-relative bindinger |
| ACreate | Tillader deterministiske manglende stier at oprette ejede native elementer med gyldige XML-navne |
| ABindingHandled | Rapporterer en eksplicit none- eller dataRef-binding håndteret af resolveren; en håndteret binding kan stadig returnere nil |
| RemainingOperations | Delt operationsration, dekrementeret for parsing, namespace-tjek og traversal; nul er opbrugt, og negativ deaktiverer denne kalder-ration |
| Deadline | Absolut frist i den leverede callbacks urdomæne eller negativ for at deaktivere forløbet-tidstjek |
| DeadlineCheck | Valgfri synkron objektmetode; nil tjekker GetTickCount64-millisekunder |
Adfærd
Den returnerede node tilhører ADocument og må ikke frigøres af kalderen; implicitte feltnavne er literal XML-navne, inklusive punktummer
DataRef-opslag understøtter $data- og $record-rødder, efterkommer-operatorer, wildcard- og klasse-selektorer, eksplicitte sibling-indeks, [*] og escapede selektortegn; se Native XFA Bind SOM for eksempler og grænser
En manglende implicit værdi i en leveret gentaget occurrence forbliver lokal for den occurrence; den falder ikke tilbage til en anden occurrence
En kompatibilitets-relativ dataRef-sti forbliver også lokal, når ADataNode leveres; record- og rod-fallback for relative referencer gælder kun, når kalderen ikke har nogen occurrence-kontekst
Skrivebeskyttet opslag allokerer ikke data-noder; oprettelse gælder deterministiske navngivne stier, mens tvetydige wildcard-, klasse- og efterkommer-søgninger forbliver opslagsoperationer
En uopløst suffiks eller exception fjerner mellemliggende noder allokeret af dette resolver-kald; tidligere eksisterende noder forbliver ejet og uændret
Traversal bruger faste grænser på 64 selektorsegmenter, 64 elementniveauer og 200000 debiterede trin pr. sti-traversal ud over de valgfrie kalder-grænser
Opbrugte operations- eller forløbet-tidsbudgetter udløser EHPDFXFAError; interaktive redigeringer og events gendanner deres omsluttende native transaktions-snapshot