THotPDF.GetLoadedNameTree Method
คืน dictionary หมวดของ name tree ในเอกสารที่โหลดไว้ จาก dictionary /Names ใน catalog โดยจะสร้างให้ใหม่เมื่อยังไม่มีก็ได้
การประกาศ
function GetLoadedNameTree(const Category: AnsiString;
CreateMissing: boolean): THPDFDictionaryObject;ยูนิต
HPDFDoc
พารามิเตอร์
| ชื่อ | วัตถุประสงค์ |
|---|---|
Category | key หมวดของ name tree ใน dictionary /Names ของ catalog เช่น Dests, JavaScript หรือ EmbeddedFiles |
CreateMissing | True เพื่อสร้าง dictionary /Names กับ dictionary หมวดเป็น indirect object ใหม่เมื่ออันใดอันหนึ่งไม่มีอยู่ False เพื่อคืน nil แทน |
ค่าที่ส่งกลับ
dictionary หมวดที่ resolve แล้ว หรือ nil เมื่อไม่มีอยู่และ CreateMissing เป็น False หรือเมื่อเอกสารไม่มี catalog ที่โหลดไว้
หมายเหตุการใช้งาน
- การสร้างจะแทนที่ entry /Names ที่ไม่ใช่ dictionary แทนที่จะ fail และทั้ง catalog กับ dictionary /Names จะถูก mark dirty เพื่อให้การเปลี่ยนแปลงลงไปใน incremental update หรือการ save รอบถัดไป
- dictionary ที่คืนมาเป็น root node ของ name tree เดินหรือแก้มันด้วย
InsertLoadedNameTreeEntryกับRemoveLoadedNameTreeEntryเพื่อให้ลำดับ key ยังถูกต้อง - ใช้
GetLoadedNameTreeRootCountไล่ดูว่ามีหมวดใดบ้างโดยไม่สร้างอะไรขึ้นมา