HPDFXFAResolveBoundDataNode
Unit: HPDFXFA
Deklarationer
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;Parametrar
| Parameter | Betydelse |
|---|---|
| ADocument | Det nativa dokumentet som äger dataset- och mallpaktenen |
| AFieldNode | Mallfältet som innehåller sin bindningsdeklaration eller sitt implicita namn |
| ADataNode | Den aktuella nativa dataförekomsten för implicita och kompatibla relativa bindningar |
| ACreate | Tillåter att deterministiska saknade sökvägar skapar ägda nativa element med giltiga XML-namn |
| ABindingHandled | Rapporterar en explicit bindning av typen none eller dataRef som hanterats av resolvaren; en hanterad bindning kan ändå returnera nil |
| RemainingOperations | Delad operationsbudget, minskad för tolkning, namnrymdskontroller och traversering; noll är förbrukad och negativ inaktiverar anroparens budget |
| Deadline | Absolut deadline i den angivna callbackens klockdomän, eller negativ för att inaktivera kontroller av förfluten tid |
| DeadlineCheck | Valfri synkron objektmetod; nil kontrollerar GetTickCount64-millisekunder |
Beteende
Den returnerade noden tillhör ADocument och får inte frigöras av anroparen; implicita fältnamn är litterala XML-namn, inklusive punkter
DataRef-uppslag stöder rötterna $data och $record, descendant-operatorer, wildcard- och klassväljare, explicita syskonindex, [*] och escape:ade väljartecken; se Native XFA-bindning med SOM för exempel och gränser
Ett saknat implicit värde i en angiven upprepad förekomst förblir lokalt för den förekomsten; den faller inte tillbaka på en annan förekomst
En kompatibel relativ dataRef-sökväg förblir också lokal när ADataNode har angetts; fallback på post och rot för relativa referenser gäller bara när anroparen saknar förekomstkontext
Skrivskyddat uppslag allokerar inte datanoder; skapande gäller deterministiska namngivna sökvägar, medan tvetydiga sökningar med wildcard, klass och descendant förblir uppslagsoperationer
En olöst suffix eller ett undantag tar bort mellanliggande noder som allokerats av detta resolversanrop; tidigare befintliga noder förblir ägda och oförändrade
Traverseringen använder fasta gränser på 64 väljarsegment, 64 elementnivåer och 200000 debiterade steg per sökvägstraversering, utöver de valfria anropargränserna
Förbrukade operations- eller tidsbudgetar ger EHPDFXFAError; interaktiva redigeringar och händelser återställer sin omslutande nativa transaktionssnapshot