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데이터셋과 템플릿 패킷을 소유한 네이티브 문서
AFieldNodebind 선언이나 암시적 이름을 담은 템플릿 필드
ADataNode암시적·호환성 상대 바인딩용 현재 네이티브 데이터 occurrence
ACreate결정론적인 없는 경로가 유효한 XML 이름으로 소유 네이티브 요소를 만들도록 허용
ABindingHandled리졸버가 처리한 명시적 none 또는 dataRef 바인딩을 보고합니다. 처리된 바인딩도 nil을 반환할 수 있습니다
RemainingOperations공유 연산 허용량으로, 파싱·네임스페이스 검사·순회마다 줄어듭니다. 0은 소진, 음수는 이 호출자 허용량을 끕니다
Deadline공급된 콜백 clock 도메인의 절대 기한이며, 음수면 경과 시간 검사를 끕니다
DeadlineCheck선택적 동기 객체 메서드입니다. nil이면 GetTickCount64 밀리초를 검사합니다

동작

반환된 노드는 ADocument에 속하며 호출자가 해제하면 안 됩니다. 암시적 필드 이름은 점을 포함해 literal XML 이름입니다

DataRef 조회는 $data와 $record 루트, descendant 연산자, wildcard·class 셀렉터, 명시적 형제 인덱스, [*], 이스케이프된 셀렉터 문자를 지원합니다. 예시와 경계는 네이티브 XFA Bind SOM을 참고하세요

공급된 반복 occurrence에서 없는 암시적 값은 그 occurrence에 머뭅니다. 다른 occurrence로 폴백하지 않습니다

호환성 상대 dataRef 경로도 ADataNode가 공급되면 그 자리에 머뭅니다. 상대 참조의 record·root 폴백은 호출자에게 occurrence 컨텍스트가 없을 때만 적용됩니다

읽기 전용 조회는 데이터 노드를 할당하지 않습니다. 생성은 결정론적인 이름 있는 경로에만 적용되고, 모호한 wildcard·class·descendant 검색은 조회 연산으로 남습니다

풀리지 않은 접미부나 예외는 이 리졸버 호출이 할당한 중간 노드를 제거합니다. 기존에 있던 노드는 소유와 내용이 그대로 유지됩니다

순회는 선택적 호출자 한도에 더해 경로 순회당 셀렉터 세그먼트 64개, 요소 레벨 64개, 청구 스텝 200000개의 고정 한도를 씁니다

연산·경과 시간 예산이 소진되면 EHPDFXFAError가 발생합니다. 대화형 편집과 이벤트는 자신을 감싼 네이티브 트랜잭션 스냅샷을 복원합니다

관련 API