THotPDF.FindStructureElementForMCID Method
페이지의 /StructParents 키를 읽고 문서 ParentTree를 상수 시간에 인덱싱하여, 주어진 (page, MCID) marked-content 시퀀스를 소유한 StructElem 사전을 찾아냅니다
선언
function FindStructureElementForMCID(PageIndex, MCID: Integer): THPDFDictionaryObject;유닛
HPDFDoc
매개변수와 결과
| 값 | 목적 |
|---|---|
PageIndex | 찾아낼 marked content가 있는 0 기준 페이지 인덱스 |
MCID | 페이지에 기록되고 AddStructureElement를 통해 ParentTree에 연결되는 marked-content 식별자 |
| 결과 | 해당 (page, MCID)를 소유한 간접 StructElem 사전이며, 페이지에 태그가 없거나 슬롯이 비어 있거나 인자가 범위를 벗어나면 nil |
동작
- 페이지의
/StructParents정수를 읽은 뒤FParentTree[key][MCID]를 곧바로 반환하므로, 조회는 structure element 수와 무관합니다 - 간접 StructElem 참조는 ParentTree 안에 링크로 감싸 저장되며, 이 메서드는 반환 전에 링크를 대상 사전으로 풀어줍니다
- 이 메서드는 예외를 던지지 않습니다. 태그 없는 페이지, 할당되지 않은 MCID,
/null자리표시자 슬롯, 범위를 벗어난 인자는 모두nil로 수렴합니다 - 반환되는 요소는
AddStructureElement가 만든 것과 동일한 간접 사전이며,AddStructureDestinationLink의/SD대상으로 적합합니다