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;Parameter
| Parameter | Bedeutung |
|---|---|
| ADocument | Das native Dokument, dem Dataset- und Template-Pakete gehören |
| AFieldNode | Das Template-Feld mit seiner bind-Deklaration oder seinem impliziten Namen |
| ADataNode | Die aktuelle native Data-Occurrence für implizite und Kompatibilitäts-Relative-Bindings |
| ACreate | Erlaubt deterministischen fehlenden Pfaden, eigene native Elemente mit gültigen XML-Namen anzulegen |
| ABindingHandled | Meldet eine explizite none- oder dataRef-Bindung, die der Resolver behandelt hat; eine behandelte Bindung kann dennoch nil liefern |
| RemainingOperations | Gemeinsames Operationskontingent, dekrementiert für Parsen, Namespace-Prüfungen und Traversierung; null ist erschöpft, ein negativer Wert deaktiviert dieses Aufrufer-Kontingent |
| Deadline | Absolute Deadline im Uhr-Domain des gelieferten Callbacks, oder negativ, um Zeitprüfungen zu deaktivieren |
| DeadlineCheck | Optionale synchrone Objektmethode; nil prüft GetTickCount64-Millisekunden |
Verhalten
Der zurückgegebene Knoten gehört zu ADocument und darf vom Aufrufer nicht freigegeben werden; implizite Feldnamen sind buchstäbliche XML-Namen, einschließlich Punkten
Die dataRef-Suche unterstützt $data- und $record-Wurzeln, Nachfahren-Operatoren, Wildcard- und Klassenselektoren, explizite Sibling-Indizes, [*] und escapte Selektorzeichen; Beispiele und Grenzen finden Sie unter Native XFA Bind SOM
Ein fehlender impliziter Wert in einer gelieferten wiederholten Occurrence bleibt lokal zu dieser Occurrence; er fällt nicht auf eine andere Occurrence zurück
Ein Kompatibilitäts-relativer dataRef-Pfad bleibt ebenfalls lokal, wenn ADataNode geliefert wird; Record- und Root-Fallback für relative Referenzen greift nur, wenn der Aufrufer keinen Occurrence-Kontext hat
Die reine Suche allokiert keine Datenknoten; Anlegen gilt für deterministische benannte Pfade, während mehrdeutige Wildcard-, Klassen- und Nachfahrensuchen Suchoperationen bleiben
Ein unaufgelöstes Suffix oder eine Ausnahme entfernt Zwischenknoten, die dieser Resolver-Aufruf allokiert hat; zuvor bestehende Knoten bleiben im Besitz und unverändert
Die Traversierung nutzt feste Limits von 64 Selektorsegmenten, 64 Elementebenen und 200000 belasteten Schritten pro Pfadtraversierung, zusätzlich zu den optionalen Aufrufer-Limits
Erschöpfte Operations- oder Zeitbudgets werfen EHPDFXFAError; interaktive Bearbeitungen und Events stellen ihren umgebenden nativen Transaktions-Snapshot wieder her