THotPDF.InsertLoadedNameTreeEntry Method
แทรกคู่ key/value ลงใน name tree ของเอกสารที่โหลดไว้ โดยคง leaf ทุกใบเรียงตาม ISO 32000-1 7.9.6
การประกาศ
procedure InsertLoadedNameTreeEntry(Tree: THPDFDictionaryObject;
const Key: AnsiString; Value: THPDFObject);ยูนิต
HPDFDoc
พารามิเตอร์
| ชื่อ | วัตถุประสงค์ |
|---|---|
Tree | root node ของ name tree ปกติได้มาจาก GetLoadedNameTree |
Key | key string ของ entry ที่ใช้เรียงลำดับ |
Value | object PDF ที่เก็บไว้กับ key นี้ ทรีเป็นเจ้าของแค่ตำแหน่งที่แทรก ตัว object เองยังเป็นส่วนหนึ่งของกราฟของเอกสารที่โหลดไว้ |
ค่าที่ส่งกลับ
เมธอดนี้ไม่ส่งค่ากลับ
หมายเหตุการใช้งาน
- ทรีที่มี /Kids จะเดินลงตาม /Limits ของแต่ละ node และขยาย limits ระหว่างทางให้ครอบคลุม key ใหม่ viewer จึงยังใช้ binary search บน leaf ได้
- การแทรก key ที่มีอยู่แล้วจะแทนที่ value เดิม ไม่ใช่เพิ่มรายการซ้ำ
- node ทุกตัวบนเส้นทางที่เดินลงไปถูก mark dirty การเปลี่ยนแปลงจึงถูกเขียนกลับในการ save หรือ incremental update ครั้งถัดไป