עבודה עם רשימות

סקירה

מדריך זה מציג כיצד רשימות ממוספרות ומסומנות מוצגות ונשלטות ב-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התווית המוצגת (טקסט וערך) לפריט רשימה ספציפי
ListTemplateEnum של פורמטים של רשימות מוגדרים מראש ב-Word

ראה גם

 עברית