עבודה עם Paragraphs

פסקה היא קבוצה של דמויות המשולבות לבלוק לוגי וסיום עם אופי מיוחד - הפסקה של פסקאות*. In In In Aspose.Words, סעיף מיוצג על ידי Paragraph מעמד.

הכנס סעיף

כדי להכניס פסקה חדשה למסמך, למעשה, עליך להכניס אליו את הדמות של פסקה. DocumentBuilder.Writeln הוספת לא רק מחרוזת של טקסט לתוך המסמך, אלא גם מוסיף הפסקה.

פורמט הגופן הנוכחי מוגדר גם על ידי Font רכוש, ותבנית הסעיף הנוכחית נקבעת על ידי ParagraphFormat רכוש. בחלק הבא נעבור לפרטים נוספים בנוגע לתבנית סעיף.

דוגמה לקוד הבא מראה כיצד להכניס פסקה למסמך:

תבנית Paragraph

פורמט הסעיף הנוכחי מיוצג על ידי ParagraphFormat אובייקט שחזר על ידי ParagraphFormat רכוש. אובייקט זה encapsulates שונים תצורה של סעיף תכונות זמין Microsoft Word. אתה יכול בקלות לאפס את הפורמט של פסקה לתוך ברירת המחדל שלה - סגנון רגיל, שמאלי, ללא הסתרה, ללא ספאק, ללא גבולות, ללא גילוח - על ידי קריאה ClearFormatting.

דוגמה לקוד הבא מראה כיצד להגדיר את סעיף הפורמט:

המונחים: Paragraph Style

כמה אובייקטים מעוצבים, כגון Font או ParagraphFormat, סגנונות תמיכה סגנון מובנה או מוגדר למשתמש מיוצג על ידי Style אובייקט, המכיל את תכונות הסגנון המתאים כמו שם, סגנון בסיס, גופן, סגנון סעיף עיצוב, וכן הלאה.

בנוסף, Style האובייקט חושף את StyleIdentifier רכוש, אשר מחזיר את מזהה הסגנון המקומי עצמאי מיוצג על ידי StyleIdentifier ערך enumeration למעשה, השמות של הסגנונות הבנויים Microsoft Word הם מקומיים לשפות שונות. באמצעות מזהה סגנון, אתה יכול למצוא את הסגנון הנכון ללא קשר לשפת המסמך. ערכי ההנצחה תואמים לערכי המובנה Microsoft Word סגנונות כגון Normal, 1 *הופנה מהדף Heading 2 וכן הלאה. כל סגנונות המוגדרים על ידי המשתמש מוגדרים StyleIdentifier.User ערך enumeration

דוגמה לקוד הבא מראה כיצד ליישם את סגנון סעיף:

המונחים: style Separator to Put different Paragraph

ניתן להוסיף לסיומו של פסקה באמצעות קיצור המקלדת Ctrl+Alt+Enter In Microsoft Word. תכונה זו מאפשרת לך להשתמש בשני סגנונות פסקה שונים באותו סעיף מודפס. אם אתה רוצה טקסט מההתחלה של כותרת מסוימת להופיע בטבלה של תוכן, אבל לא רוצה את כל הכותרת להראות בטבלה של תוכן, אתה יכול להשתמש פונקציה זו.

הדוגמה הבאה של הקוד מראה כיצד להוסיף מפריד סגנון כדי להתאים סגנונות פסקה שונים:

זיהוי Paragraph סגנון ספרדי

Aspose.Words חושף את BreakIsStyleSeparator רכוש ציבורי על Paragraph שיעור לזהות פסקה עם מפריד סגנון, כפי שמוצג בדוגמה להלן:

החל את הגבולות והמשך לפסקה

גבולות Aspose.Words מיוצגים על ידי BorderCollection מעמד – זהו אוסף של Border פריטים אשר נגישים על ידי אינדקס או על ידי סוג גבול. סוג הגבול הוא בתורו מיוצג על ידי BorderType אזהרה. כמה ערכי enumeration חלים על מספר רב או רק אלמנט מסמך אחד. לדוגמה, BorderType.Bottom חל על סעיף או תא שולחן, BorderType.DiagonalDown מציג גבול דיגוני בתא שולחן בלבד.

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

Aspose.Words יש גם את Shading שיעור המכיל תכונות קידוד עבור רכיבי מסמך. אתה יכול להגדיר את המרקם והצבעים הרצויים מוחלים על הרקע ואת הבסיס של אלמנט באמצעות האלמנט תוך שימוש TextureIndex ערך enumeration TextureIndex גם מאפשר לך ליישם דפוסים שונים Shading אובייקט. לדוגמה, כדי להגדיר את צבע הרקע עבור אלמנט מסמך, השתמש ב TextureIndex.TextureSolid ערך ולהגדיר את הצבע הקדמי מתאים.

הדוגמה הבאה של הקוד מראה כיצד ליישם את הגבולות ולהשפיל לפסקה:

Count Paragraph Lines

אם ברצונך לספור את מספר השורות בפסקה עבור כל מסמך Word, ניתן להשתמש במדגם הקוד הבא: