ReadStructureElements 메서드

컴포넌트: TPdf · 유닛: PDFium

한 페이지에 뿌리를 둔 구조 트리의 소유권 있는 스냅샷을 읽어 옵니다

Syntax

function ReadStructureElements(PageNumber: Integer; const Options: TPdfStructureReadOptions; out Status: TPdfStructureReadStatus): TPdfStructureElements;

Description

ReadStructureElements는 PageNumber(1 기반)의 태그 구조 트리를 순회하고 타입, 제목, MCID, 자식 인덱스, 참조 정보를 담은 소유권 있는 TPdfStructureElements 배열을 반환합니다

Status는 빈 결과의 이유를 설명하며 태그가 없는 문서와 한도에 걸리거나 실패한 읽기를 구별합니다

Remarks

문서가 구조 트리를 아예 가지고 있는지는 먼저 IsTagged로 확인하세요
반복 읽기는 구조 캐시로 충족됩니다. StructureCacheCapacity와 StructureElementsForPage를 참고하세요
아주 깊은 트리는 전체 배열을 만들어 내는 대신 방문을 스트리밍하는 VisitStructureElements가 유리합니다

Example

var St: TPdfStructureReadStatus;
Elements := Pdf1.ReadStructureElements(1, Default(TPdfStructureReadOptions), St);