DestinationCount 속성

DestinationCount는 문서에 등록된 named destination 개수, 즉 catalog의 /Dests 딕셔너리나 /Names /Dests 이름 트리를 통해 도달할 수 있는 항목 개수를 알려 줍니다(PDF 1.7 스펙 12.3.2.3절) named destination은 문자열 레이블을 대상 페이지, 뷰포트 사각형, 선택적 확대 배율에 묶으며, 북마크, 링크 주석, 원격 이동 액션은 destination을 인라인이나 이름으로 참조합니다

Active가 False이거나 named destination이 선언되지 않았으면 값은 0입니다(링크와 북마크는 인라인 명시적 destination으로 여전히 동작할 수 있고, 이 개수에는 “이름 붙은” 방식만 참여합니다) 0부터 DestinationCount - 1까지의 인덱스로 Destination[Index]를 호출하면 TDestination 레코드를 얻습니다 (handle, name, page number, X/Y/Zoom, 그리고 어느 필드가 명시적으로 저장되어 있는지 알려 주는 has 플래그)

PDFium이 매번 이름 트리를 훑기 때문에 접근 한 번당 O(n) 비용이 듭니다 이름으로 반복 조회할 때는 수동 루프 대신 DestinationByName[Name]을 쓰세요 — PDFium이 내부적으로 균형 트리 탐색을 수행해 선형 스캔보다 규모에 유리합니다

• named destination은 보통 작성 도구가 상호 참조(그림 번호, 수식 레이블, 용어집 항목)를 위해 자동 생성합니다
• 이 값으로 PDF의 “구조화된 상호 링크” 수준을 가늠할 수 있습니다 — 보고서와 책에는 수백 개의 destination이 있는 반면, 스캔한 청구서는 보통 0개입니다
• 아웃라인 트리만 따라가면 되는 경우라면 Bookmarks 프로퍼티 쪽이 더 직접적이며, named destination은 주로 다른 PDF에서 들어오는 원격 참조를 다룰 때 의미가 있습니다