HPDFXFAResolveBoundDataNode
Unità: HPDFXFA
Dichiarazioni
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;Parametri
| Parametro | Significato |
|---|---|
| ADocument | Il documento nativo proprietario dei pacchetti dataset e template |
| AFieldNode | Il campo template contenente la sua dichiarazione bind o il nome implicito |
| ADataNode | L'occorrenza dati nativa corrente per i binding relativi impliciti e di compatibilità |
| ACreate | Consente ai percorsi mancanti deterministici di creare elementi nativi di proprietà con nomi XML validi |
| ABindingHandled | Riporta un binding none o dataRef esplicito gestito dal resolver; un binding gestito può comunque restituire nil |
| RemainingOperations | Riserva condivisa di operazioni, decrementata per parsing, controlli di namespace e traversata; zero significa esaurita e un valore negativo disabilita questa riserva del chiamante |
| Deadline | Deadline assoluto nel dominio di clock della callback fornita, o negativo per disabilitare i controlli di tempo trascorso |
| DeadlineCheck | Metodo oggetto sincrono opzionale; nil controlla i millisecondi di GetTickCount64 |
Comportamento
Il nodo restituito appartiene ad ADocument e non deve essere liberato dal chiamante; i nomi di campo impliciti sono nomi XML letterali, punti inclusi
La lookup dataRef supporta radici $data e $record, operatori descendant, selettori wildcard e class, indici sibling espliciti, [*] e caratteri selettore con escape; vedi Bind SOM XFA nativo per esempi e confini
Un valore implicito mancante in un'occorrenza ripetuta fornita resta locale a quell'occorrenza; non ripiega su un'altra occorrenza
Anche un percorso dataRef relativo di compatibilità resta locale quando ADataNode è fornito; il fallback record e root per i riferimenti relativi si applica solo quando il chiamante non ha context di occorrenza
La lookup read-only non alloca nodi dati; la creazione si applica ai percorsi nominali deterministici, mentre le ricerche wildcard, class e descendant ambigue restano operazioni di lookup
Un suffisso non risolto o un'eccezione rimuove i nodi intermedi allocati da questa chiamata del resolver; i nodi preesistenti restano di proprietà e invariati
La traversata usa limiti fissi di 64 segmenti selettore, 64 livelli elemento e 200000 step addebitati per traversata di percorso, in aggiunta ai limiti opzionali del chiamante
Budget di operazioni o di tempo esauriti sollevano EHPDFXFAError; le modifiche interattive e gli eventi ripristinano lo snapshot della transazione nativa contenitore