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;

Parameters

ParametrZnaczenie
ADocumentNatywny dokument posiadający pakiety dataset i szablonu
AFieldNodePole szablonu zawierające deklarację bind albo nazwę niejawną
ADataNodeBieżące natywne wystąpienie danych dla powiązań niejawnych i względnych kompatybilnościowych
ACreatePozwala deterministycznym brakującym ścieżkom tworzyć posiadane elementy natywne o poprawnych nazwach XML
ABindingHandledRaportuje jawne powiązanie none albo dataRef obsłużone przez resolver; obsłużone powiązanie nadal może zwrócić nil
RemainingOperationsWspółdzielony przydział operacji, dekrementowany za parsowanie, sprawdzenia przestrzeni nazw i traversalu; zero to wyczerpanie, a ujemny wyłącza ten przydział wywołującego
DeadlineAbsolutny deadline w domenie zegara dostarczonego callbacka, albo ujemny wyłączający sprawdzenia upływu czasu
DeadlineCheckOpcjonalna synchroniczna metoda obiektu; nil sprawdza milisekundy GetTickCount64

Behavior

Zwrócony węzeł należy do ADocument i nie może być zwalniany przez wywołującego; niejawne nazwy pól to literalne nazwy XML, łącznie z kropkami

Odpytanie DataRef wspiera korzenie $data i $record, operatory potomków, dzikie karty i selektory klas, jawne indeksy rodzeństwa, [*] i escape'owane znaki selektora; zobacz Native XFA Bind SOM po przykłady i granice

Brakująca niejawna wartość w dostarczonym powtarzalnym wystąpieniu pozostaje lokalna dla tego wystąpienia; nie robi fallbacku do innego wystąpienia

Względna ścieżka dataRef kompatybilnościowa też pozostaje lokalna, gdy ADataNode jest dostarczone; fallback rekordu i korzenia dla referencji względnych stosuje się wyłącznie, gdy wywołujący nie ma kontekstu wystąpienia

Odpytanie tylko do odczytu nie alokuje węzłów danych; tworzenie dotyczy deterministycznych ścieżek nazwanych, podczas gdy dwuznaczne wyszukiwania dzikich kart, klas i potomków pozostają operacjami odpytania

Nierozpoznany sufiks albo wyjątek usuwa węzły pośrednie alokowane przez to wywołanie resolvera; wcześniej istniejące węzły pozostają posiadane i niezmienione

Traversalu używa stałych limitów 64 segmentów selektora, 64 poziomów elementów i 200000 obciążonych kroków na traversalu ścieżki, dodatkowo do opcjonalnych limitów wywołującego

Wyczerpane budżety operacji albo upływu czasu podnoszą EHPDFXFAError; interaktywne edycje i zdarzenia przywracają swój otaczający natywny snapshot transakcji

Related APIs