VisitStructureElements 메서드

컴포넌트: TPdf · 유닛: PDFium

한 페이지의 구조 트리를 방문자 콜백으로 스트리밍합니다

Syntax

function VisitStructureElements(PageNumber: Integer; const Options: TPdfStructureReadOptions; Visitor: TPdfStructureElementVisitor; out Status: TPdfStructureReadStatus): Integer;

Description

VisitStructureElements는 PageNumber(1 기반)의 구조 트리를 순회하면서 전체 TPdfStructureElements 배열을 만드는 대신 요소 하나하나마다 Visitor를 호출합니다

반환값은 방문한 요소 수이며, Status는 ReadStructureElements와 같은 방식으로 한도에 걸리거나 실패한 읽기를 보고합니다

Remarks

스트리밍은 구체화된 스냅샷이라면 넘쳐버릴 깊은 계층에서도 메모리를 평탄하게 유지합니다
방문자는 요소 정보의 소유 복사본을 받으므로 네이티브 핸들이 순회 밖으로 새어 나가지 않습니다

Example

Count := Pdf1.VisitStructureElements(1, Options, procedure(const E: TPdfStructureElement)
begin
Log(E.TypeName);
end, Status);