עבודה עם סעיפים
לפעמים אתה רוצה מסמך שאין לו אותו עיצוב בכל הדפים. לדוגמה, ייתכן שיהיה עליך לשנות פורמטים של מספר עמוד, להיות בעל גודל וכיוון עמוד שונים, או שיהיה לך את דף המסמך הראשון כעמוד שער ללא כל מספור. אתה יכול להשיג את זה עם קטעים.
חלקים הם צמתים ברמה השולטים בכותרות עליונות ותחתונות, כיוון, עמודות, שוליים, עיצוב מספר עמוד ואחרים.
Aspose.Words מאפשר לך לנהל קטעים, לחלק מסמך למקטעים ולבצע שינויים בעיצוב החלים רק על קטע ספציפי. Aspose.Words מאחסן מידע על עיצוב מקטעים כגון כותרות עליונות ותחתונות, הגדרת עמוד והגדרות עמודות במעבר המקטע.
מאמר זה מסביר כיצד לעבוד עם קטעים והפסקות קטעים.
מה קטע וקטע הפסקה
קטעי המסמך מיוצגים על ידי הכיתות Section ו - SectionCollection. אובייקטים של סעיף הם ילדים מיידיים של הצומת Document וניתן לגשת אליהם דרך המאפיין Sections. אתה יכול לנהל את הצמתים האלה באמצעות כמה שיטות כגון Remove, Add, IndexOf, ואחרים.
מעבר מקטע הוא אפשרות המחלקת דפי מסמכים למקטעים עם פריסות הניתנות להתאמה אישית.
סוגי מעבר מקטע
Aspose.Words מאפשר לך לפצל ולעצב מסמכים באמצעות מעברי קטעים שונים של הספירה BreakType:
- SectionBreakContinuous
- SectionBreakNewColumn
- SectionBreakNewPage
- SectionBreakEvenPage
- SectionBreakOddPage
אתה יכול גם להשתמש בספירה SectionStart כדי לבחור סוג הפסקה שחל רק על החלק הראשון כגון NewColumn, NewPage, EvenPage, ו - OddPage.
ניהול קטע
מאחר שחלק הוא צומת מורכב רגיל, ניתן להשתמש בכל מניפולציה של הצומת API כדי לתמרן חלקים: להוסיף, להסיר ופעולות אחרות בחלקים. אתה יכול לקרוא עוד על צמתים במאמר Aspose.Words מודל אובייקט מסמך (DOM).
מצד שני, אתה יכול גם להשתמש ב DocumentBuilder API לעבוד עם קטעים. במאמר זה, נתמקד בדרך מסוימת זו של עבודה עם חלקים.
הוספה או הסרה של מעבר מקטע
Aspose.Words מאפשר לך להוסיף קטע מעבר לטקסט בשיטת InsertBreak.
דוגמת הקוד הבאה מראה כיצד להוסיף פריצת מקטע למסמך:
השתמש בשיטת Remove כדי למחוק מעבר מקטע. אם אינך צריך להסיר מעבר מקטע ספציפי ובמקום זאת למחוק את התוכן של אותו קטע, תוכל להשתמש בשיטת ClearContent.
דוגמת הקוד הבאה מראה כיצד להסיר מעברי קטעים:
העבר קטע
אם ברצונך להעביר קטע ממיקום אחד למשנהו במסמך שלך, עליך לקבל את האינדקס של אותו קטע. Aspose.Words מאפשר לך לקבל מיקום מקטע מ SectionCollection. אתה יכול להשתמש במאפיין Sections כדי לקבל את כל הסעיפים במסמך שלך. אבל אם אתה רוצה לקבל רק את החלק הראשון, אתה יכול להשתמש במאפיין FirstSection.
דוגמת הקוד הבאה מראה כיצד לגשת לחלק הראשון ולחזור דרך הילדים של צומת מורכב:
ציין פריסת מקטע
לפעמים אתה רוצה שהמסמך שלך ייראה טוב יותר על ידי יצירת פריסות יצירתיות עבור קטעי מסמכים שונים. אם ברצונך לציין את סוג רשת המקטעים הנוכחית, תוכל לבחור מצב פריסת מקטעים באמצעות ספירת SectionLayoutMode:
- ברירת מחדל
- רשת
- LineGrid
- SnapToChars
דוגמת הקוד הבאה מראה כיצד להגביל את מספר השורות שעשויות להיות בכל עמוד:
עריכת קטע
כשאתה מוסיף קטע חדש למסמך שלך, לא יהיה גוף או פסקה שתוכל לערוך. Aspose.Words מאפשר לך להבטיח שקטע מכיל גוף עם פיסקה אחת לפחות בשיטת EnsureMinimum - הוא יוסיף אוטומטית צומת גוף (או HeaderFooter) למסמך ואז יוסיף לו פסקה.
דוגמת הקוד הבאה מראה כיצד להכין צומת קטע חדש באמצעות EnsureMinimum:
הוסף או הוסף תוכן מראש
אם ברצונך לצייר צורה כלשהי או להוסיף טקסט או תמונה בתחילת/סוף קטע, תוכל להשתמש בשיטות AppendContent ו - PrependContent של הכיתה Section.
דוגמת הקוד הבאה מראה כיצד להוסיף תוכן של קטע קיים:
שיבוט קטע
Aspose.Words מאפשר לך לשכפל קטע על ידי יצירת עותק מלא שלו בשיטת Clone.
דוגמת הקוד הבאה מראה כיצד לשכפל את החלק הראשון במסמך שלך:
העתק קטעים בין מסמכים
במקרים מסוימים, ייתכן שיש לך מסמכים גדולים עם חלקים רבים ואתה רוצה להעתיק את התוכן של קטע ממסמך אחד למשנהו.
Aspose.Words מאפשר לך להעתיק קטעים בין מסמכים בשיטת ImportNode.
דוגמת הקוד הבאה מראה כיצד להעתיק קטעים בין מסמכים:
עבודה עם כותרת עליונה ותחתונה
הכללים הבסיסיים להצגת כותרת עליונה או תחתונה עבור כל קטע הם פשוטים למדי:
- אם לקטע אין כותרות עליונות / תחתונות משלו מסוג מסוים, הוא נלקח מהקטע הקודם.
- סוג הכותרת העליונה / התחתונה המוצגת בדף נשלט על ידי הגדרות הקטע" עמוד ראשון שונה “ו” דפים מוזרים ואחידים שונים " – אם הם מושבתים, מתעלמים מהכותרות של הקטע עצמו.
דוגמת הקוד הבאה מראה כיצד ליצור 2 קטעים עם כותרות שונות:
אם ברצונך להסיר את הטקסט של כותרות עליונות ותחתונות מבלי להסיר HeaderFooter אובייקטים במסמך, תוכל להשתמש בשיטה ClearHeadersFooters. בנוסף, תוכל להשתמש בשיטת DeleteHeaderFooterShapes כדי להסיר את כל הצורות מכותרות עליונות ותחתונות במסמך שלך.
דוגמת הקוד הבאה מראה כיצד לנקות תוכן מכל הכותרות העליונות והתחתונות בקטע:
דוגמת הקוד הבאה כיצד להסיר את כל הצורות מכל הכותרות התחתונות בסעיף:
התאמה אישית של מאפייני דף במקטע
לפני הדפסת דף או מסמך ייתכן שתרצה להתאים אישית ולשנות את הגודל והפריסה של דף בודד או של המסמך כולו. עם הגדרת הדף, באפשרותך לשנות את ההגדרות של דפי מסמכים כגון שוליים, כיוון וגודל להדפסת דפים ראשונים שונים או דפים מוזרים.
Aspose.Words מאפשר לך להתאים אישית את מאפייני הדף והקטע באמצעות הכיתה PageSetup.
דוגמת הקוד הבאה מראה כיצד להגדיר מאפיינים כגון גודל עמוד וכיוון עבור החלק הנוכחי:
דוגמת הקוד הבאה מראה כיצד לשנות את מאפייני הדף בכל הסעיפים: