THotPDF.GetLoadedNameTree Method
دیکشنری دستهٔ name tree سند بارگذاری‌شده را از دیکشنری /Names کاتالوگ برمی‌گرداند و در اولین استفاده می‌تواند آن را بسازد
اعلان
function GetLoadedNameTree(const Category: AnsiString;
CreateMissing: boolean): THPDFDictionaryObject;واحد
HPDFDoc
پارامترها
| نام | هدف |
|---|---|
Category | کلید دستهٔ name tree در دیکشنری /Names کاتالوگ، مثلاً Dests، JavaScript یا EmbeddedFiles |
CreateMissing | True تا در صورت غیبت هر کدام، دیکشنری /Names و دیکشنری دسته به‌عنوان indirect objectهای جدید ساخته شوند؛ False برای اینکه به‌جایش nil برگردد |
مقدار بازگشت
دیکشنری دستهٔ resolveشده، یا nil وقتی موجود نیست و CreateMissing برابر False است، یا وقتی سند کاتالوگ بارگذاری‌شده ندارد
یادداشت‌های استفاده
- ساختن به‌جای شکست خوردن، مدخل /Names غیردیکشنری را جایگزین می‌کند و هم کاتالوگ و هم دیکشنری /Names dirty علامت می‌خورند تا تغییر در به‌روزرسانی افزایشی یا ذخیرهٔ بعدی بنشیند
- دیکشنری برگشتی یک گره ریشه از name tree است؛ پیمایش یا ویرایشش را با
InsertLoadedNameTreeEntryوRemoveLoadedNameTreeEntryانجام دهید تا ترتیب کلیدها معتبر بماند - برای فهرست کردن دسته‌های موجود بدون ساختن چیزی از
GetLoadedNameTreeRootCountاستفاده کنید