עבודה עם רשימות
סקירה
מדריך זה מציג כיצד רשימות ממוספרות ומסומנות מוצגות ונשלטות ב-Aspose.Words FOSS עבור .NET. List הוא הגדרת רשימה ניתנת לשימוש חוזר המשותפת לכל פסקה שמשתמשת בה, ListFormat הוא האופן שבו פסקה בודדת מתייחסת לרשימה ולרמה הנוכחית שלה, ו-ListLevel מחזיק את העיצוב האמיתי של המספור או ההדגשה עבור רמה אחת של רשימה.
אובייקט הרשימה ו-ListCollection
List מייצג הגדרת רשימה אחת — כללי המספור שהמסמך יכול להחיל על פסקאות רבות. List.ListId מזהה אותה, List.IsMultiLevel מדווח האם היא מגדירה יותר מרמה אחת, ו-List.ListLevels מחזיר ListLevelCollection המכיל ListLevel אחת לכל רמה שהרשימה מגדירה. List.IsListStyleDefinition ו-IsListStyleReference מבחינים בין רשימה שמגדירה את העיצוב שלה לבין רשימה שמתייחסת לעיצוב דרך Style מקושר (זמין דרך List.Style). כל הרשימות של המסמך נגישות דרך Document.Lists, שמחזיר ListCollection: ListCollection.Add(listTemplate) יוצר רשימה חדשה מאחת הפורמטים המוגדרים מראש של Word ב-ListTemplate, Add(listStyle) יוצר אחת מ-Style, AddSingleLevelList(listTemplate) יוצר גרסא ברמת-אחת, ו-AddCopy(srcList) משכפל רשימה קיימת — שימושי כאשר רוצים שהפסקאות יקבלו מספור עצמאי (אתחול חדש) במקום לשתף את אותו מונה. ListCollection.GetListByListId(listId) מאחזר רשימה ספציפית, ו-Count מדווח כמה רשימות יש למסמך.
החלת רשימות על פסקאות עם ListFormat
ListFormat, המושג מהעיצוב של פסקה, שולט באיזו רשימה פסקה שייכת ובאיזו רמה. ListFormat.List הוא ה-List שהפסקה משתמשת בו, ו-ListFormat.ListLevelNumber הוא הרמה שמתחילה מאפס בתוך אותה רשימה; IsListItem מדווח האם הפסקה היא חלק מרשימה בכלל. ApplyBulletDefault() ו-ApplyNumberDefault() מחילים את עיצוב ברירת המחדל של Word לרשימות תבליט או ממוספרות על פסקה בקריאה אחת, RemoveNumbers() מסיר את עיצוב הרשימה, ו-ListIndent()/ListOutdent() מזיזים פסקה עמוק יותר או רמה אחת פחות ברשימה — אותה פעולות שמבצע Word כאשר לוחצים Tab או Shift+Tab בתחילת פסקת רשימה.
רמות רשימה וסגנון מספור
ListLevel מחזיק את העיצוב של רמת רשימה אחת: NumberStyle (ערך enum של NumberStyle כגון ספרות ערבית או ספרות רומיות), NumberFormat (מחרוזת העיצוב המשלבת את המספר עם טקסט מילולי, כגון נקודה או סוגריים), StartAt (מספר ההתחלה), ו-RestartAfterLevel (איזו רמה גבוהה יותר שההגדלה שלה מאתחלת מחדש את המונה של רמה זו). Alignment (ערך של ListLevelAlignment: Left, Center, Right) ו-TrailingCharacter (ערך של ListTrailingCharacter: Tab, Space, Nothing) שולטות במיקום ובידוד של התווית מטקסט הפסקה, יחד עם TabPosition, NumberPosition ו-TextPosition לתכנון מדויק. IsLegal מכפה מספור בסגנון משפטי (תמיד ערבי, ללא קשר ל-NumberStyle), ו-LinkedStyle מקשר את הרמה לפסקת Style. עבור תבליטים תמונתיים, CreatePictureBullet() ו-DeletePictureBullet() מנהלים תמונת תבליט ImageData, ו-ListLevel.Font מגדיר את העיצוב של המספר או תו התבליט עצמו. ListLevel.GetEffectiveValue(index, numberStyle, customNumberStyleFormat) מחשב את ערך התווית האמיתי במיקום נתון ברצף המספור.
תוויות רשימות ותבניות מוגדרות מראש
ListLabel מתאר את התווית המוצגת למופע ספציפי של פריט ברשימה — LabelString הוא הטקסט המילולי שמציג Word (כגון “3.” או “•”), LabelValue הוא הערך המספרי הבסיסי, ו-Font הוא העיצוב של התווית. ListTemplate הוא enum של תבניות רשימה מוגדרות מראש ב-Word (סגנונות תבליט כגון BulletDefault, BulletDisk, BulletCircle, BulletSquare, BulletDiamonds, ותבניות ממוספרות), המשמש עם ListCollection.Add(listTemplate) כדי להתחיל מתבנית מובנית במקום לבנות אחת תכונה אחר תכונה.
טיפים ושיטות עבודה מומלצות
- השתמש ב-
ListCollection.AddCopy(srcList)כאשר קבוצה חדשה של פסקאות דורשת מספור רשימה שמתחיל מחדש באופן עצמאי, במקום להשתמש ב-Listשכבר מצורף לפסקאות אחרות. - העדף להשתמש ב-
ListFormat.ApplyNumberDefault()/ApplyBulletDefault()עבור רשימות סטנדרטיות במקום להגדיר ידנית כל תכונה שלListLevel. - בדוק את
List.IsListStyleReferenceמולIsListStyleDefinitionלפני שינוי ישיר של עיצוב הרשימה — ייתכן שהעיצוב של רשימה המתייחסת לסגנון נשלט על-ידי ה-Styleהמקושר שלה. - הגדר את
RestartAfterLevelבמפורש ברשימות משורשרות במקום להסתמך על התנהגות האיפוס המוגדרת כברירת מחדל כאשר יש צורך לאפס את המספור ברמות מתאר ספציפיות. - השתמש ב-
ListFormat.ListIndent()/ListOutdent()כדי להעביר פסקה בין רמות רשימה במקום להגדיר אתListLevelNumberישירות, מכיוון ששיטות אלה משמרות את עיצוב הרשימה של הפסקה עקבי פנימית.
בעיות נפוצות
| בעיה | סיבה | תיקון |
|---|---|---|
| שתי פסקאות שצריכות למספר באופן עצמאי ממשיכות את אותה סדרה | ה-ListFormat.List של שתי הפסקאות מתייחס לאותו אובייקט List משותף | הענק לפסקה השנייה רשימה משלה באמצעות ListCollection.AddCopy(srcList) במקום להשתמש באותו List |
| מחרוזת פורמט מספר מותאם אישית אינה מוצגת כצפוי | ListLevel.NumberFormat אינו תואם לתבנית הצפויה של NumberStyle ברמה | ודא שה-NumberFormat וה-NumberStyle מוגדרים באופן עקבי עבור הרמה שנערכת |
| הזחת הרשימה נראית שגויה לאחר שינוי הרמות באופן תכנותי | ListLevelNumber הוגדר ישירות ללא עדכון של תכונות המיקום הקשורות | השתמש ב-ListFormat.ListIndent()/ListOutdent() במקום להגדיר את ListLevelNumber ישירות |
| תבליט תמונה אינו מופיע | לא נוצר תבליט תמונה עבור הרמה, או שהעיצוב ברירת המחדל של תבליט טקסט עדיין פעיל | קרא ל-ListLevel.CreatePictureBullet() וספק את נתוני התמונה לפני הסרת העיצוב של תבליט הטקסט |
FAQ
מה ההבדל בין List ל-ListFormat?
List הוא ההגדרה המשמשת למספרים/תבליטים שניתנת לשימוש חוזר ומשותפת בין פסקאות; ListFormat הוא לכל פסקה — הוא מצביע על איזה List פסקה ספציפית משתמשת ובאיזו רמה, באמצעות ListFormat.List ו-ListLevelNumber.
איך לבדוק האם פסקה היא חלק מרשימה?
קרא את ListFormat.IsListItem על העיצוב של הפסקה; אם true, ListFormat.List ו-ListLevelNumber מתארים לאיזו רשימה ולאיזו רמה היא שייכת.
איך לגרום לרשימה חדשה להתחיל למספר מ-1 באופן עצמאי מרשימה קיימת?
השתמש ב-ListCollection.AddCopy(srcList) כדי ליצור עותק עצמאי של הגדרת הרשימה, ולאחר מכן להחיל את העותק על הפסקאות החדשות — במקום להשתמש שוב ב-List המקורי, מה שהיה ממשיך את אותו מונה.
איך אני יוצר רשימה עם תבליטים או רשימה ממוספרת מההתחלה?
השתמש ב-ListFormat.ApplyBulletDefault() או ב-ApplyNumberDefault() עבור העיצוב המוגדר כברירת מחדל ב-Word, או ב-ListCollection.Add(listTemplate) עם ערך ListTemplate כדי להתחיל מאחד מהפורמטים המוגדרים מראש של Word ולהתאים את ה-List.ListLevels המתקבל משם.
איך אני שולט בפורמט המספר, כגון “1)” במקום “1.”?
הגדר את ListLevel.NumberFormat ברמה הרלוונטית למחרוזת הפורמט הרצויה, יחד עם NumberStyle עבור סגנון המספר עצמו.
API Reference סיכום
| מחלקה/מתודה | תיאור |
|---|---|
List | הגדרת רשימה ניתנת לשימוש חוזר (מספור/תבליט) |
ListCollection | האוסף של כל הרשימות במסמך |
ListCollection.Add(listTemplate) / AddCopy(srcList) | צור רשימה מתבנית מוגדרת מראש, או העתק רשימה קיימת |
ListFormat | התייחסות לפי פסקה ל-List ולרמה הנוכחית |
ListFormat.ApplyBulletDefault() / ApplyNumberDefault() | החל עיצוב ברירת מחדל של תבליט או מספור על פסקה |
ListLevel | עיצוב מספור/תבליט לרמה אחת של List |
ListLevel.NumberStyle / NumberFormat | סגנון המספר ומחרוזת העיצוב לרמה |
ListLabel | התווית המוצגת (טקסט וערך) לפריט רשימה ספציפי |
ListTemplate | Enum של פורמטים של רשימות מוגדרים מראש ב-Word |