עבודה עם סעיפים
לפעמים אתה רוצה מסמך שאין לו אותו פורמט בכל הדפים. לדוגמה, ייתכן שיהיה עליך לשנות פורמטי מספר העמוד, יש גודל וכיוון שונים, או שיש לך את דף המסמך הראשון כעמוד כיסוי ללא מספר. אתה יכול להשיג את זה עם חלקים.
סעיפים הם בלוטות רמות השולטות ראשים והולכי רגל, אוריינטציה, עמודות, שוליים, שוליים, מספר העמודים פורמט, ואחרים.
Aspose.Words מאפשר לך לנהל חלקים, לחלק מסמך לחלקים, ולבצע שינויים עיצוב החל רק על סעיף מסוים. Aspose.Words מאחסנת מידע על פורמט סעיף כגון Headers and Footers, דף ההתקנה והגדרות עמודה בפסקה.
מאמר זה מסביר כיצד לעבוד עם חלקים וקטעים.
איזה סעיף ופסקה הם
סעיפים של מסמכים מיוצגים על ידי Section ו SectionCollection שיעורים. חפצים הם ילדים מיידיים של Document צומת וניתן לגשת אליו באמצעות Sections רכוש. אתה יכול לנהל את הנקודות האלה באמצעות כמה שיטות כגון Remove, Add, IndexOf, ואחרים.
הפסקה של סעיף היא אפשרות שמחלקת דפי מסמך לחלקים עם פריסות מותנות אישית.
סוגים של הפסקה
Aspose.Words מאפשר להפיץ ולעצב מסמכים באמצעות הפסקות חלקים שונות של BreakType המונחים:
- קטגוריה:BreakContinense
- תגית:BreakNewColumn
- תגית:BreakNewPage
- תגית:Break EvenPage
- תגית:BreakOdPage
אתה יכול גם להשתמש SectionStart בהנחה לבחור סוג הפסקה שחל רק על החלק הראשון כגון NewColumn, NewPage, EvenPage, ו- OddPage.
נהל סעיף
מכיוון שסעיף הוא צומת מורכב רגיל, כל מניפולציה הצומת API ניתן להשתמש כדי לתמרן חלקים: להוסיף, להסיר ופעולות אחרות על חלקים. אתה יכול לקרוא עוד על צמתים במאמר Aspose.Words Document Object Model (DOM).
מצד שני, אתה יכול גם להשתמש DocumentBuilder
API לעבוד עם חלקים במאמר זה נתמקד בדרך מסוימת זו של עבודה עם חלקים.
הוסף או להסיר פסקה
Aspose.Words מאפשר להוסיף קטע לפרוץ לטקסט באמצעות InsertBreak שיטה.
הדוגמה הבאה של הקוד מראה כיצד להכניס חלק לתוך מסמך:
השתמש Remove שיטה למחוק הפסקה. אם אתה לא צריך להסיר הפסקה מסוימת ובמקום זאת למחוק את התוכן של סעיף זה, אתה יכול להשתמש ClearContent שיטה.
דוגמה לקוד הבא מראה כיצד להסיר הפסקות:
הזיז סעיף
אם אתה רוצה להעביר קטע ממקום אחד למשנהו במסמך שלך, אתה צריך לקבל את המדד של סעיף זה. Aspose.Words מאפשר לך לקבל מיקום חלק מ SectionCollection. אתה יכול להשתמש Sections לרכוש את כל החלקים במסמך שלך. אם אתה רוצה לקבל רק את החלק הראשון, אתה יכול להשתמש FirstSection רכוש.
הדוגמה הבאה של הקוד מראה כיצד לגשת לחלק הראשון ולהתפתל דרך הילדים של צומת מורכב:
המונחים: a part Layout
לפעמים אתה רוצה שהמסמך שלך ייראה טוב יותר על ידי ביצוע פריסות יצירתיות עבור קטעי מסמך שונים. אם ברצונך לציין את סוג רשת הסעיף הנוכחית, באפשרותך לבחור מצב פריסת חלק באמצעות טופס SectionLayoutMode המונחים:
- Default
- גרי
- LineGrid
- SnapToChars
הדוגמה הבאה של הקוד מראה כיצד להגביל את מספר השורות שיש לכל דף:
לערוך סעיף
כאשר אתה מוסיף סעיף חדש במסמך שלך, לא יהיה גוף או סעיף שניתן לערוך. Aspose.Words מאפשר לך להבטיח כי סעיף מכיל גוף עם סעיף אחד לפחות באמצעות סעיף אחד. EnsureMinimum שיטה – היא תוסיף באופן אוטומטי גוף (או HeaderFooter) צומת למסמך ולאחר מכן תוסיף סעיף לכך.
הדוגמה הבאה של הקוד מראה כיצד להכין פסקה חדשה באמצעות EnsureMinimum:
עדכון או Prepend content
אם אתה רוצה לצייר צורה כלשהי או להוסיף טקסט או תמונה בתחילת / סיום של סעיף, אתה יכול להשתמש AppendContent ו PrependContent שיטות של Section מעמד.
הדוגמה הבאה של הקוד מראה כיצד לתקן תוכן של סעיף קיים:
סימן לסעיף
Aspose.Words מאפשר לשכפל סעיף על ידי יצירת עותק מלא של זה באמצעות deepClone שיטה.
הדוגמה הבאה של הקוד מראה כיצד לשחזר את הקטע הראשון במסמך שלך:
העתק בין מסמכים
במקרים מסוימים, ייתכן שיש לך מסמכים גדולים עם חלקים רבים ואתה רוצה להעתיק את התוכן של סעיף מ מסמך אחד למשנהו.
Aspose.Words מאפשר לך להעתיק חלקים בין מסמכים באמצעות ImportNode שיטה.
דוגמה לקוד הבא מראה כיצד להעתיק קטעים בין מסמכים:
עבודה עם מדורה Header and Footer
הכללים הבסיסיים להצגת ראש או רגל לכל חלק הם פשוטים למדי:
1.1 1. אם לסעיף אין ראשים/מרגלים משלו מסוג מסוים, הוא נלקח מהחלק הקודם. 2. הסוג של Header/footer המוצג בעמוד נשלט על ידי “העמוד הראשון” ו-“Different Odd & Even Pages” הגדרות - אם הן מוגבלות, אז הכותרות של הקטע תעלמו.
לדוגמה הקוד הבא מראה כיצד ליצור 2 חלקים עם ראשים שונים:
אם אתה רוצה להסיר את הטקסט של ראשים והולכי רגל מבלי להסיר HeaderFooter אובייקטים במסמך שלך, אתה יכול להשתמש ClearHeadersFooters שיטה. בנוסף, אתה יכול להשתמש DeleteHeaderFooterShapes שיטה להסיר את כל הצורות של Headers ו Footers במסמך שלך.
הדוגמה הבאה של הקוד מראה כיצד לנקות תוכן של כל הראשים וההולכי הרגל בסעיף:
דוגמה נוספת לקוד כיצד להסיר את כל הצורות מכל ההולכי רגל בראש בסעיף:
Customize Page Properties in a Part
לפני הדפסה דף או מסמך ייתכן שתרצה להתאים אישית ולשנות את הגודל ואת הפריסה של דף אחד או את המסמך כולו. עם הגדרת דף, אתה יכול לשנות את ההגדרות של דפי מסמך כגון שולי, אוריינטציה וגודל להדפסה של דפים ראשונים שונים או דפים מוזרים.
Aspose.Words מאפשר לך להתאים אישית דף ותכונות סעיף באמצעות PageSetup מעמד.
לדוגמה הקוד הבא מראה כיצד להגדיר תכונות כגון גודל דף וכיוון לסעיף הנוכחי:
הדוגמה הבאה של הקוד מראה כיצד לשנות את תכונות העמוד בכל הסעיפים: