THotPDF.GetLoadedNameTree Method
catalog /Names 사전에서 로드한 문서의 이름 트리 카테고리 사전을 반환하고, 처음 쓰는 것이면 만들어 줄 수도 있습니다
선언
function GetLoadedNameTree(const Category: AnsiString;
CreateMissing: boolean): THPDFDictionaryObject;유닛
HPDFDoc
매개변수
| 이름 | 목적 |
|---|---|
Category | catalog /Names 사전의 이름 트리 카테고리 키입니다. 예컨대 Dests, JavaScript, EmbeddedFiles가 있습니다 |
CreateMissing | True면 /Names 사전과 카테고리 사전이 없을 때 새 indirect object로 만들고, False면 그 대신 nil을 반환합니다 |
반환 값
해석된 카테고리 사전을 반환합니다. 사전이 없는데 CreateMissing이 False이거나, 로드된 catalog가 없으면 nil입니다
사용 참고 사항
- 만들 때 사전이 아닌 /Names 항목이 있어도 실패하지 않고 교체하며, catalog와 /Names 사전을 dirty로 표시해 다음 증분 업데이트나 저장에 변경이 반영되게 합니다
- 반환된 사전은 이름 트리의 루트 노드입니다. 키 정렬이 깨지지 않게 하려면
InsertLoadedNameTreeEntry와RemoveLoadedNameTreeEntry로 탐색하고 편집합니다 - 아무것도 만들지 않고 어떤 카테고리가 있는지 훑어보려면
GetLoadedNameTreeRootCount를 사용합니다