HPDFXFAResolveBoundDataNode
Unité : HPDFXFA
Déclarations
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;Paramètres
| Paramètre | Signification |
|---|---|
| ADocument | Le document natif propriétaire des paquets dataset et template |
| AFieldNode | Le champ de template contenant sa déclaration de bind ou son nom implicite |
| ADataNode | L'occurrence de données native courante pour les bindings implicites et relatifs de compatibilité |
| ACreate | Permet aux chemins manquants déterministes de créer des éléments natifs détenus avec des noms XML valides |
| ABindingHandled | Signale un binding none ou dataRef explicite traité par le resolver ; un binding traité peut quand même retourner nil |
| RemainingOperations | Quota d'opérations partagé, décrémenté pour le parsing, les vérifications de namespace et le parcours ; zéro signifie épuisé et un négatif désactive ce quota d'appelant |
| Deadline | Échéance absolue dans le domaine d'horloge du callback fourni, ou négative pour désactiver les vérifications de temps écoulé |
| DeadlineCheck | Méthode d'objet synchrone optionnelle ; nil vérifie les millisecondes GetTickCount64 |
Comportement
Le nœud retourné appartient à ADocument et ne doit pas être libéré par l'appelant ; les noms de champs implicites sont des noms XML littéraux, points inclus
La recherche dataRef prend en charge les racines $data et $record, les opérateurs descendant, les sélecteurs wildcard et classe, les indices de frères explicites, [*] et les caractères de sélecteur échappés ; voir Bind SOM XFA natif pour des exemples et limites
Une valeur implicite manquante dans une occurrence répétée fournie reste locale à cette occurrence ; elle ne retombe pas sur une autre occurrence
Un chemin dataRef relatif de compatibilité reste aussi local quand ADataNode est fourni ; le fallback record et racine pour les références relatives ne s'applique que quand l'appelant n'a pas de contexte d'occurrence
La recherche en lecture seule n'alloue pas de nœuds de données ; la création s'applique aux chemins nommés déterministes, tandis que les recherches ambiguës wildcard, classe et descendant restent des opérations de recherche
Un suffixe non résolu ou une exception supprime les nœuds intermédiaires alloués par cet appel du resolver ; les nœuds préexistants restent détenus et inchangés
Le parcours utilise des limites fixes de 64 segments de sélecteur, 64 niveaux d'éléments et 200000 étapes facturées par parcours de chemin, en plus des limites optionnelles de l'appelant
Des budgets d'opérations ou de temps écoulé épuisés lèvent EHPDFXFAError ; les éditions interactives et événements restaurent leur snapshot de transaction native englobant