הסרת עצירות טאב מותאמות ברמות רשימה נותנת שליטה מדויקת על פריסת הרשימות במסמכי Word. התכונה Removing List Level Tab Stops מוסיפה שיטה פשוטה ListLevel.RemoveTabStop() שמוחקת כל עצירת טאב שהוגדרה בעבר. מאמר זה מנחה אותך כיצד להתקין את ה‑SDK, ליצור רשימה, להסיר את עצירת הטאב שלה ולשמור את המסמך המעודכן.

למה להסיר עצירות טאב ברמת רשימה במסמך Word

רשימות Word תלויות לעיתים במרווח טאב ברירת מחדל שמיישר את מספר הרשימה או את הכדור עם הטקסט. כאשר מסמך נוצר באופן תכנותי, ייתכן ותוסיף מרווח טאב מותאם אישית כדי להשיג יישור חזותי ספציפי. מאוחר יותר, דרישות עסקיות עשויות להשתנות, או שתצטרך להשתמש באותו תבנית עבור פריסה שונה. עריכה ידנית של המסמך למחיקת מרווח הטאב היא גוזלת זמן ונוטה לטעויות. עם ListLevel.RemoveTabStop(), ניתן לחזור באופן תכנותי לרמת הרשימה להתנהגות ברירת המחדל, ולהבטיח עקביות במסמכים שנוצרו ללא התערבות ידנית.

הצגת API של ListLevel

Aspose.Words for .NET מספק מודל אובייקטים עשיר למניפולציה של מסמכי Word. המחלקה ListLevel מייצגת רמה יחידה בתוך רשימה (לדוגמה, הרמה הראשונה של רשימה ממוספרת). החל מגרסה 26.7, המחלקה כוללת את המתודה RemoveTabStop(), שמסירה כל עצירת טאב מותאמת אישית שהוגדרה ברמה זו.

כדי להתחיל, התקן את חבילת Aspose.Words מ‑NuGet:

Install-Package Aspow.Words

תוכל ללמוד עוד על המוצר בדף המוצר של Aspose.Words for .NET. תיעוד מפורט זמין ב-Aspose.Words .NET docs, והפנייה המלאה ל‑API ניתן לחקור כאן.

הסר עצירת טאב מותאמת מרמת רשימה יחידה

מדריך שלב‑אחר‑שלב

  1. צור מסמך חדש ו-DocumentBuilder. האובייקט Document מחזיק את קובץ ה-Word בזיכרון, בעוד DocumentBuilder מפשט את יצירת התוכן.
  2. החל פורמט רשימה ממוספרת ברירת מחדל. זה נותן לנו רשימה עם רמה מוגדרת מראש ועצירת טאב.
  3. כתוב כמה פריטי רשימה. הפריטים יורשים את עיצוב הרשימה.
  4. קבל את ListLevel הנוכחי מהבונה. זהו הרמה שיצרנו זה עתה.
  5. קרא RemoveTabStop() על ה-ListLevel. פעולה זו מוחקת את עצירת הטאב המותאמת.
  6. שמור את המסמך כדי לאמת את השינוי.

הדוגמה הבאה מציגה כיצד להסיר עצירת טאב מותאמת ברמת רשימה באמצעות C# ו‑Aspose.Words.

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Create a list with default formatting
builder.ListFormat.ApplyNumberDefault();
builder.Writeln("Numbered list item 1");
builder.Writeln("Numbered list item 2");

// Get the list level and remove its tab stop
ListLevel listLevel = builder.ListFormat.ListLevel;
listLevel.RemoveTabStop();

doc.Save("Paragraph.RemoveTabStopFromListLevel.docx");

איך זה עובד

  • builder.ListFormat.ApplyNumberDefault() מעביר את הבונה למצב רשימה ממוספרת תוך שימוש בסגנון הרשימה המוגדר כברירת מחדל ב‑Word. פעולה זו יוצרת באופן מרומז אובייקט List חדש ו‑ListLevel תואם לרמה הראשונה.
  • builder.Writeln(...) כותב שני פריטי רשימה. מכיוון שהבונה נמצא במצב רשימה, כל קריאה מוסיפה אוטומטית את מספר הרשימה המתאים ומיישרת את הטקסט בהתבסס על טאב‑סטופ של הרמה.
  • builder.ListFormat.ListLevel מחזיר את המופע ListLevel ששולט בעיצוב של רמת הרשימה הנוכחית (רמה 0 במקרה זה).
  • listLevel.RemoveTabStop() מוחק את טאב‑סטופ המותאם שהוגדר כאשר נוצרה רמת הרשימה. לאחר קריאה זו, הרשימה תשתמש בטאב‑סטופ ברירת המחדל של Word, שבדרך כלל ממוקם במרחק השוליים השמאליים של הרמה.
  • doc.Save(...) כותב את המסמך בזיכרון לקובץ בשם Paragraph.RemoveTabStopFromListLevel.docx. פתחו את הקובץ ב‑Microsoft Word או בכל מציג תואם כדי לראות שהמספרים והטקסט מיושרים כעת באמצעות טאב‑סטופ ברירת המחדל.

הערה: קוד זה משוכתב מההערות הרשמיות של Aspose.Words ולא בוצע בסביבת sandbox. יש לאמת אותו בסביבת הפיתוח שלכם לפני השימוש בייצור.

הסרת עצירות טאב מכל רמות הרשימה במסמך

בתרחישים רבים מהעולם האמיתי, מסמך מכיל רשימות מרובות, כל אחת עם כמה רמות. הסרת עצירת טאב מרמה אחת בלבד עשויה לא להיות מספיקה. הקטע הבא מציג כיצד לעבור על כל רשימה במסמך ולמחוק את עצירת הטאב בכל רמה.

// Load an existing document that contains multiple lists
Document doc = new Document("Input.docx");

// Iterate through every list in the document
foreach (List list in doc.Lists)
{
    // Each list can have multiple levels (0‑8). Iterate them.
    foreach (ListLevel level in list.ListLevels)
    {
        // Remove any custom tab stop for this level
        level.RemoveTabStop();
    }
}

// Save the updated document
doc.Save("Output_NoTabStops.docx");

הסבר של הקוד

  • new Document("Input.docx") טוען קובץ Word קיים שעשוי להכיל מספר רשימות.
  • doc.Lists מחזיר אוסף של אובייקטים מסוג List המייצגים כל רשימה ייחודית במסמך.
  • list.ListLevels מספק גישה לתשעה הרמות האפשריות (0‑8) עבור הרשימה הזו. גם אם רמה אינה משומשת, האוסף עדיין מכיל מופע של ListLevel עם עיצוב ברירת מחדל.
  • בתוך הלולאה הפנימית, level.RemoveTabStop() נקרא על כל רמה, מה שמבטיח שלא יישארו עצירות טאב מותאמות אישית בשום מקום במסמך.
  • לבסוף, doc.Save("Output_NoTabStops.docx") כותב את המסמך שנוקה.

גישה זו שימושית במיוחד כאשר עליך לאכוף פריסת רשימה אחידה על פני אצווה של דוחות שנוצרו או כאשר אתה מנרמל מסמכים שהתקבלו ממקורות חיצוניים.

הוספה תכנותית ולאחר מכן הסרת נקודת טאב

לפעמים ייתכן שתצטרכו להוסיף עצירת טאב מותאמת אישית עבור פריסת זמנית, לבצע כמה פעולות, ואז לחזור לברירת המחדל. ה‑SDK מאפשר לכם להוסיף עצירת טאב באמצעות ListLevel.TabStops.Add(double position). לאחר סיום העיצוב הזמני, תוכלו לקרוא ל‑RemoveTabStop() כדי לנקות.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.ListFormat.ApplyNumberDefault();
builder.Writeln("Temporarily aligned item 1");

// Add a custom tab stop at 72 points (1 inch)
ListLevel level = builder.ListFormat.ListLevel;
level.TabStops.Add(72);

builder.Writeln("Item with custom tab stop");

// Later, remove the custom tab stop
level.RemoveTabStop();

builder.Writeln("Item after removing tab stop");

doc.Save("TempTabStopDemo.docx");

הסבר על הקוד

  • לאחר יצירת המסמך והחלת רשימה ממוספרת, אנו כותבים את הפריט הראשון.
  • level.TabStops.Add(72) מוסיף עצירת טאב מותאמת אישית ב‑72 נקודות (בדיוק אינץ’ אחד). הפריט הבא ברשימה מיישר את הטקסט שלו במיקום זה.
  • לאחר שהעיצוב הזמני אינו נדרש יותר, level.RemoveTabStop() מסיר את עצירת הטאב המותאמת, מה שגורם לפריטים הבאים לחזור ליישור ברירת המחדל.
  • Writeln הסופי מדגים את האפקט של ההסרה.

תבנית זו נוחה כאשר אתה צריך התאמה חד‑פעמית — למשל, ליישר כותרת בתוך רשימה עבור פריסת עמוד ספציפית — תוך שמירה על שאר המסמך נקי.

קבל רישיון חינמי

Aspose מציעה רישיון חינמי זמני שמסיר את סימני המים של ההערכה ומעניק גישה מלאה ל‑API לצורך פיתוח ובדיקה. ניתן לבקש אחד מדף דף הרישיון הזמני של Aspose.

משאבים נוספים בחינם

סיכום

בהדרכה זו כיסינו כיצד להשתמש במתודה החדשה ListLevel.RemoveTabStop() שהוצגה ב‑Aspose.Words 26.7. על‑ידי ניקוי עצירות טאב מותאמות, אתם משחזרים שליטה על יישור הרשימות, מפשטים תבניות מסמכים ומבטיחים פורמט עקבי בקבצי Word שנוצרו. הדוגמאות הציגו הסרה לרמת רשימה אחת, הסרה גורפת בכל המסמך, ותבנית להתאמות זמניות של עצירות טאב. שילוב הטכניקות הללו ביישומי .NET שלכם יהפוך את האוטומציה של Word לחזקה יותר וקלה יותר לתחזוקה.

שאלות נפוצות

  1. מה ListLevel.RemoveTabStop() למעשה מסיר?
    המתודה מוחקת כל טאב סטופ מותאם אישית שהוגדר עבור רמת הרשימה, ומחזירה את הרמה להשתמש בטאב סטופ ברירת המחדל שהוגדר על‑ידי סגנון המסמך.

  2. האם עליי לקרוא ל‑Save() לאחר הסרת עצירת טאב?
    כן. השינויים נעשים בזיכרון, ולכן עליך לקרוא ל‑Document.Save() כדי לשמור את עיצוב הרשימה המעודכן לקובץ.

  3. האם אני יכול להסיר עצירות טאב מכל רמות הרשימה במסמך אחד?
    בהחלט. ניתן לעבור על כל List במסמך ולאחר מכן על כל ListLevel, ולהפעיל RemoveTabStop() לפי הצורך.

  4. האם RemoveTabStop() נתמך גם עבור רשימות עם תבליטים וגם עבור רשימות ממוספרות?
    כן. המתודה פועלת על כל ListLevel ללא קשר אם הוא מייצג תבליט, מספר, או פורמט מרובה רמות.

  5. האם הסרת עצירת טאב מותאמת אישית תשפיע על ההזחה של פריטי רשימה קיימים?
    רק מיקום עצירת הטאב משתנה. ההזחה הכוללת המוגדרת על ידי ההזחה השמאלית של רמת הרשימה נשארת ללא שינוי, ולכן פריטי הרשימה שומרים על ההיררכיה החזותית שלהם.

  6. האם אני צריך רישיון בתשלום כדי להשתמש ב-ListLevel.RemoveTabStop()?
    ה-API זמין ברישיון זמני חינמי, אך לשימוש בייצור יש לקבל רישיון מלא מ‑Aspose.

קרא עוד