THotPDF.InsertLoadedNameTreeEntry Method
يدرج زوج مفتاح/قيمة في شجرة أسماء محمّلة ويُبقي كل عقدة ورقية مرتبةً وفق ISO 32000-1 7.9.6
التصريح
procedure InsertLoadedNameTreeEntry(Tree: THPDFDictionaryObject;
const Key: AnsiString; Value: THPDFObject);وحدة
HPDFDoc
المعاملات
| الاسم | الغرض |
|---|---|
Tree | عقدة جذر لشجرة أسماء، تُؤخذ عادةً من GetLoadedNameTree |
Key | سلسلة المفتاح المرتبة للمدخل |
Value | كائن PDF المخزَّن للمفتاح؛ الشجرة تتولى ملكية تموضع الإدراج فقط، ويبقى الكائن جزءًا من مخطط الكائنات المحمّل |
قيمة الإرجاع
لا يعيد هذا العضو قيمة
ملاحظات الاستخدام
- الشجرة ذات /Kids تُطوَف عبر /Limits لعقدِها، وتُوسَّع الحدود في الطريق لتشمل المفتاح الجديد، فتواصل العارضات اعتماد البحث الثنائي فوق الأوراق
- إدراج مفتاح موجود يستبدل قيمته بدلًا من إضافة مكرر
- كل عقدة على مسار النزول تُعلَّم كغير محفوظة، فيُكتب التغيير عند الحفظ التالي أو التحديث التزايدي