HPDFXFAResolveFieldValueNode

Unit: HPDFXFA

Declaration

function HPDFXFAResolveFieldValueNode(Document: TXFADocument;
  FieldNode, DataNode: TXFANode; CreateNode: Boolean= False;
  MaxNodes: Integer= 65536): TXFANode; overload;

function HPDFXFAResolveFieldValueNode(Document: TXFADocument;
  FieldNode, DataNode: TXFANode; CreateNode: Boolean;
  MaxNodes: Integer; var RemainingOperations: Integer; Deadline: Int64;
  DeadlineCheck: TXFABindingDeadlineCheck = nil): TXFANode; overload;

Parametre

Parameter	Betydning
`Document`	Det native XFA-dokument, der ejer felt-, data- og formularpakkerne
`FieldNode`	Skabelonfeltet, hvis effektive værdi anmodes
`DataNode`	Dataset occurrence-konteksten; gentagne felter kræver deres egen occurrence-kontekst
`CreateNode`	False opløser læsbar data, en formularværdi eller skabelonstandard; True returnerer en skrivbar instance-værdi
`MaxNodes`	Occurrence-grænsen sendt til native formular instance-oprettelse

Adfærd

En eksisterende bundet dataset-node vinder, selv når dens indhold er tomt; en manglende node falder tilbage til den tilsvarende native formularværdi og derefter til det første value-barn i skabelonfeltet

Skrivebeskyttet opslag opretter ingen dataset- eller formularnode og returnerer nil, når ingen af disse værdikilder findes

Med CreateNode True opretter eller returnerer normal databinding den skrivbare dataset-node; et ubundet felt eller et dokument uden skrivbare datasets bruger i stedet en separat native formularværdi

En nyligt oprettet dataset-node kan initialt være tom; kalderen leverer den committede værdi i stedet for at tildele gennem en tidligere returneret skabelonstandard

Den returnerede node tilhører Document og må ikke frigøres af kalderen; skrivebeskyttet opslag kan returnere en delt skabelonnode, så hent en skrivbar node med CreateNode True, inden dens indhold ændres

Null Document eller FieldNode returnerer nil; overdrevne native formular occurrence-indeks eller forfader-dybde udløser EHPDFXFAError gennem form-resolveren

Consumers

Det budgetterede overload deler kalderens operationsration og frist med native binding-opløsning; nul RemainingOperations er opbrugt, negativ deaktiverer kalder-rationen, og en negativ Deadline deaktiverer forløbet-tidstjek

DeadlineCheck kan levere kalderens urdomæne; nil bruger GetTickCount64-millisekunder, mens den interaktive runtime leverer sit konfigurerede monotone deadline-tjek

Binding-scanninger beholder faste segment-, traversal-dybde- og debiteret trin-grænser; budgetfejl udløser EHPDFXFAError, og interaktive transaktioner gendanner deres native snapshot

Se HPDFXFAResolveBoundDataNode og TXFABindingDeadlineCheck for binding-budget- og callback-kontrakterne

Den interaktive runtime og XFA AcroForm-konvertering deler denne resolver og holder manglende standarder, eksplicit tomme data og gentagne occurrence-værdier konsistente

Interaktive redigeringer og beregninger genanskaffer en skrivbar instance-node inden commit og bevarer skabelonstandarden for andre instances

Relaterede API'er

Native XFA feltstandarder, HPDFXFAResolveFormInstanceNode og Interactive Dynamic XFA Widget Runtime