HPDFXFAResolveFieldValueNode

Enheten är HPDFXFA

Deklaration

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;

Parametrar

Parameter	Betydelse
`Document`	Det nativa XFA-dokument som äger fält-, data- och formulärpaket
`FieldNode`	Mallfältet vars effektiva värde begärs
`DataNode`	Datasetförekomstkontexten; upprepade fält kräver sin egen förekomstkontext
`CreateNode`	False löser läsbar data, ett formulärvärde eller mallstandarden; True returnerar ett skrivbart instansvärde
`MaxNodes`	Förekomstgränsen som skickas till nativt formulärinstansskapande

Beteende

En befintlig bunden datasetnod vinner även när dess innehåll är tomt; en saknad nod faller tillbaka till motsvarande nativt formulärvärde och därefter till det första värdebarnet i mallfältet

En skrivskyddad uppslagning skapar ingen dataset- eller formulärnod och returnerar nil när ingen av dessa värdekällor finns

Med CreateNode True skapar eller returnerar normal databindning den skrivbara datasetnoden; ett obundet fält eller ett dokument utan skrivbara datasets använder i stället ett separat nativt formulärvärde

En nyskapad datasetnod kan initialt vara tom; anroparen tillhandahåller det sparade värdet i stället för att tilldela genom en tidigare returnerad mallstandard

Den returnerade noden tillhör Document och får inte frigöras av anroparen; skrivskyddad uppslagning kan returnera en delad mallnod, så hämta en skrivbar nod med CreateNode True innan dess innehåll ändras

Null Document eller FieldNode returnerar nil; överdrivna nativa formulärförekomstindex eller förfaderdjup kastar EHPDFXFAError genom formulärresolvern

Konsumenter

Den budgeterade överladdningen delar anroparens operationstilldelning och tidsgräns med nativ bindningsupplösning; noll RemainingOperations är uttömd, negativ stänger av anropartilldelningen och en negativ Deadline stänger av förloppstidskontroller

DeadlineCheck kan tillhandahålla anroparens klockdomän; nil använder GetTickCount64-millisekunder, medan den interaktiva körtiden tillhandahåller sin konfigurerade monotoniska tidsgränskontroll

Bindningsskanningar behåller fasta segment-, traverseringsdjup- och debiterade-steg-gränser; budgetfel kastar EHPDFXFAError och interaktiva transaktioner återställer sin nativ ögonblicksbild

Se HPDFXFAResolveBoundDataNode och TXFABindingDeadlineCheck för bindningsbudget- och återanropskontrakten

Den interaktiva körtiden och XFA AcroForm-konverteringen delar denna resolver, vilket håller saknade standarder, explicit tom data och upprepad förekomstvärden konsekventa

Interaktiva redigeringar och beräkningar återhämtar en skrivbar instansnod före sparande och bevarar mallstandarden för andra instanser

Relaterade API:er

Nativa XFA-fältstandarder, HPDFXFAResolveFormInstanceNode och Interaktiv dynamisk XFA-widgetkörtid