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 propietario de los paquetes dataset y template |
| AFieldNode | El campo de la plantilla que contiene su declaración bind o nombre implícito |
| ADataNode | La ocurrencia de datos nativa actual para bindings implícitos y relativos de compatibilidad |
| ACreate | Permite que las rutas ausentes deterministas creen elementos nativos propios con nombres XML válidos |
| ABindingHandled | Informa de un binding none o dataRef explícito atendido por el resolver; un binding atendido puede devolver nil igualmente |
| RemainingOperations | Permiso de operaciones compartido, decrementado por parsing, comprobaciones de namespace y recorrido; cero significa agotado y un valor negativo desactiva este permiso del llamante |
| Deadline | Deadline absoluta en el dominio de reloj del callback suministrado, o negativa para desactivar las comprobaciones de tiempo transcurrido |
| DeadlineCheck | Método de objeto síncrono opcional; nil comprueba los milisegundos de GetTickCount64 |
Comportamiento
El nodo devuelto pertenece a ADocument y el llamante 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 descendant, selectores wildcard y class, índices de hermanos explícitos, [*] y caracteres de selector escapados; ver Bind SOM nativo de XFA para ejemplos y límites
Un valor implícito ausente en una ocurrencia repetida suministrada se queda en 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 solo se aplica cuando el llamante no tiene contexto de ocurrencia
La búsqueda de solo lectura no asigna nodos de datos; la creación se aplica a rutas con nombre deterministas, mientras que las búsquedas ambiguas wildcard, class y descendant 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 llamante
Los presupuestos de operaciones o de tiempo agotados lanzan EHPDFXFAError; las ediciones interactivas y los eventos restauran la instantánea de la transacción nativa que los envuelve