THotPDF.GetLoadedNameTree Method
מחזיר את מילון קטגוריית עץ-השמות של המסמך הטעון מתוך מילון ה-/Names של ה-catalog, עם אפשרות ליצור אותו בשימוש הראשון
הצהרה
function GetLoadedNameTree(const Category: AnsiString;
CreateMissing: boolean): THPDFDictionaryObject;יחידה
HPDFDoc
פרמטרים
| שם | מטרה |
|---|---|
Category | מפתח קטגוריה של עץ השמות במילון ה-/Names של ה-catalog, למשל Dests, JavaScript או EmbeddedFiles |
CreateMissing | True כדי ליצור את מילון ה-/Names ואת מילון הקטגוריה כ-indirect objects חדשים כאשר אחד מהם חסר; False כדי להחזיר nil במקום |
ערך החזרה
מילון הקטגוריה לאחר פתירה, או nil כאשר הוא חסר ו-CreateMissing הוא False, או כאשר למסמך אין catalog טעון
הערות שימוש
- יצירה מחליפה רשומת /Names שאינה מילון במקום להיכשל, וגם ה-catalog וגם מילון ה-/Names מסומנים כ-dirty כך שהשינוי נכנס לעדכון המצטבר או לשמירה הבאים
- המילון שמוחזר הוא צומת שורש של עץ שמות; סורקים או עורכים אותו עם
InsertLoadedNameTreeEntryו-RemoveLoadedNameTreeEntryכדי שסדר המפתחות יישאר תקין - משתמשים ב-
GetLoadedNameTreeRootCountכדי למנות אילו קטגוריות קיימות בלי ליצור כלום