HPDFXFAResolveBoundDataNode

Модуль: HPDFXFA

Объявления

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;

Параметры

ПараметрСмысл
ADocumentНативный документ, владеющий пакетами данных и шаблона
AFieldNodeПоле шаблона со своим объявлением bind или неявным именем
ADataNodeТекущее нативное вхождение данных для неявных и совместимых относительных привязок
ACreateРазрешает детерминированным отсутствующим путям создавать собственные нативные элементы с корректными XML-именами
ABindingHandledСообщает об явной привязке none или dataRef, обработанной резолвером; обработанная привязка всё равно может вернуть nil
RemainingOperationsОбщий лимит операций, уменьшаемый за разбор, проверки пространств имён и обход; ноль — исчерпан, отрицательное значение отключает лимит этого вызывающего
DeadlineАбсолютный дедлайн в системе отсчёта переданного callback или отрицательное значение, чтобы отключить проверки времени
DeadlineCheckНеобязательный синхронный метод объекта; nil включает проверку миллисекунд GetTickCount64

Поведение

Возвращённый узел принадлежит ADocument и не должен освобождаться вызывающим; неявные имена полей — литеральные XML-имена, включая точки

Поиск по dataRef поддерживает корни $data и $record, операторы descendant, селекторы wildcard и class, явные индексы сиблингов, [*] и экранированные символы селекторов; примеры и границы — в Нативный XFA Bind SOM

Отсутствующее неявное значение в переданном повторном вхождении остаётся локальным для этого вхождения и не откатывается к другому

Совместимый относительный путь dataRef тоже остаётся локальным, когда передан ADataNode; fallback к record и корню для относительных ссылок работает только при отсутствии контекста вхождений у вызывающего

Поиск только для чтения не выделяет узлы данных; создание применяется к детерминированным именованным путям, а неоднозначные поиски wildcard, class и descendant остаются операциями поиска

Неразрешённый суффикс или исключение удаляет промежуточные узлы, выделенные этим вызовом резолвера; ранее существовавшие узлы остаются во владении и без изменений

Обход использует фиксированные лимиты: 64 сегмента селектора, 64 уровня элементов и 200000 учитываемых шагов на обход пути — сверх опциональных лимитов вызывающего

Исчерпанные бюджеты операций или времени возбуждают EHPDFXFAError; интерактивные правки и события восстанавливают объемлющий нативный снимок транзакции

Связанные API