THotPDF.GetLoadedNameTree Method

تعيد قاموس فئة شجرة الأسماء (name tree) للمستند المحمّل من قاموس /Names في كاتالوج المستند، مع إمكانية إنشائه عند أول استخدام

التصريح

function GetLoadedNameTree(const Category: AnsiString;
  CreateMissing: boolean): THPDFDictionaryObject;

HPDFDoc

الاسم	الغرض
`Category`	مفتاح فئة شجرة الأسماء في قاموس /Names للكاتالوج، مثل `Dests` أو `JavaScript` أو `EmbeddedFiles`
`CreateMissing`	قيمة True لإنشاء قاموس /Names وقاموس الفئة ككائنين غير مباشرين جديدَين عند غياب أي منهما؛ وقيمة False لإعادة nil بدلًا من ذلك

قاموس الفئة بعد فك مرجعه، أو nil عندما يكون مفقودًا و CreateMissing تساوي False، أو عندما لا يمتلك المستند كاتالوجًا محمّلًا

الإنشاء يستبدل مدخل /Names غير القاموسي بدلًا من الفشل، ويُعلَّم كل من الكاتالوج وقاموس /Names كغير محفوظَين حتى يسقط التغيير في التحديث التزايدي التالي أو في الحفظ
القاموس المعاد هو عقدة جذر لشجرة أسماء؛ تجوّل فيه أو عدّله عبر InsertLoadedNameTreeEntry و RemoveLoadedNameTreeEntry لتبقى ترتيبيات المفاتيح سليمة
استخدم GetLoadedNameTreeRootCount لسرد الفئات الموجودة من دون إنشاء أي شيء