HPDFXFAResolveBoundDataNode
Unit: HPDFXFA
Declaraciones
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;Parámetros
| Parámetro | Significado |
|---|---|
| ADocument | El documento nativo que posee los paquetes dataset y template |
| AFieldNode | El campo de template que contiene su declaración bind o nombre implícito |
| ADataNode | La ocurrencia de datos nativa actual para bindings relativos implícitos y de compatibilidad |
| ACreate | Permite que las rutas faltantes deterministas creen elementos nativos propios con nombres XML válidos |
| ABindingHandled | Reporta un binding none o dataRef explícito manejado por el resolver; un binding manejado aún puede devolver nil |
| RemainingOperations | Autorización de operaciones compartida, decrementada por parsing, verificaciones de namespace y recorrido; cero significa agotada y negativo desactiva esta autorización del llamador |
| Deadline | Deadline absoluto en el dominio de reloj del callback suministrado, o negativo para desactivar las verificaciones de tiempo transcurrido |
| DeadlineCheck | Método de objeto síncrono opcional; nil verifica los milisegundos de GetTickCount64 |
Comportamiento
El nodo devuelto pertenece a ADocument y el llamador no debe liberarlo; los nombres de campo implícitos son nombres XML literales, incluidos los puntos
La búsqueda dataRef soporta raíces $data y $record, operadores descendientes, selectores wildcard y de clase, índices explícitos de hermanos, [*] y caracteres de selector escapados; ver Bind SOM nativo de XFA para ejemplos y límites
Un valor implícito faltante en una ocurrencia repetida suministrada se queda local a esa ocurrencia; no hace fallback a otra ocurrencia
Una ruta dataRef relativa de compatibilidad también se queda local cuando se suministra ADataNode; el fallback de record y raíz para referencias relativas aplica solo cuando el llamador no tiene contexto de ocurrencia
La búsqueda de solo lectura no asigna nodos de datos; la creación aplica a rutas con nombre deterministas, mientras que las búsquedas ambiguas wildcard, de clase y descendientes siguen siendo operaciones de búsqueda
Un sufijo sin resolver o una excepción elimina los nodos intermedios asignados por esta llamada al resolver; los nodos previamente existentes siguen siendo propios y sin cambios
El recorrido usa límites fijos de 64 segmentos de selector, 64 niveles de elemento y 200000 pasos cobrados por recorrido de ruta, además de los límites opcionales del llamador
Los presupuestos de operaciones o de tiempo transcurrido agotados lanzan EHPDFXFAError; las ediciones interactivas y los eventos restauran la instantánea de transacción nativa que los contiene